Skip to content

Abdullahjalaly/nixos-cloud-image

Repository files navigation

πŸš€ nixos-cloud-image - Effortless cloud images for any provider

Download

πŸš€ Getting Started

Welcome to the nixos-cloud-image project! This software helps you easily deploy NixOS cloud images across various platforms like Hetzner, AWS, DigitalOcean, Vultr, and Proxmox. No technical skills needed! Just follow these steps to get started.

πŸ“₯ Download & Install

To download the software, visit the Releases page. You will find different versions of the nixos-cloud-image software there. Choose the latest version and download it.

πŸ–₯️ System Requirements

Before installing, ensure your system meets the following requirements:

  • A computer or server with at least 1 GB of RAM.
  • A reliable internet connection for downloading images.
  • Compatible with your chosen cloud service provider (like AWS or DigitalOcean).

πŸ“‚ Features

  • Universal Compatibility: Use images across various cloud providers.
  • Minimal Builds: Enjoy lightweight, netboot-style images.
  • SOPS Support: Secure your data with built-in support for SOPS.
  • Auto-Deployment: Simplify setup with cloud-init for seamless launches.
  • Infrastructure as Code: Manage your infrastructure with a declarative approach.

🌐 Supported Providers

You can use nixos-cloud-image with the following cloud providers:

  • Hetzner
  • AWS
  • DigitalOcean
  • Vultr
  • Proxmox

πŸ“– How to Use

  1. Choose a Provider: Decide on the cloud platform you want to use.
  2. Download an Image: Go to the Releases page and download the latest cloud image for your provider.
  3. Upload to Cloud: Using your cloud provider's interface, upload the downloaded image to your account.
  4. Set Up Your Instance: Follow your provider's instructions to create a new server instance with the uploaded image.

πŸ“Š Configuration

You can easily configure your cloud instance with cloud-init. After setting up your instance, modify the cloud-init configurations as needed for your specific use case, such as setting user credentials or configuring network settings.

πŸ”§ Troubleshooting Common Issues

If you encounter any problems while using nixos-cloud-image, here are some common solutions:

  • Image Not Booting: Ensure that you selected the correct image type (e.g., ISO for netboot).
  • Installation Failures: Verify your internet connection and retry the download.
  • Authentication Issues: Double-check your credentials and permissions for the cloud provider.

πŸ“¬ Support

If you need help or have questions, feel free to raise an issue in the GitHub repository. You can also check the existing issues to find solutions others may have already pointed out.

For a better understanding, refer to the Documentation available in the repository.

πŸ“₯ Quick Download Link

Don't forget to visit the Releases page again to download the latest version whenever it is released, ensuring you have the best features and fixes available.

Thank you for choosing nixos-cloud-image. Enjoy seamless cloud deployments!

About

πŸŒ₯️ Build minimal, automated NixOS cloud images for any provider, featuring auto-updates, smart swap sizing, and dynamic filesystem expansion.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors