HomelabOS is a collection of Ansible scripts that allow you to quickly and easily set up a self-hosted home server. In this tutorial, we'll go over the steps to install HomelabOS on nixOS Latest.
Before we begin, make sure you have the following prerequisites:
The first step is to install Git. Git is a version control system and we'll use it to clone the HomelabOS repository. To install Git, run the following command:
sudo nix-env -i git
Next, we'll clone the HomelabOS repository. To do this, run the following command:
git clone https://github.com/homelabos/homelabos.git
This will create a directory named homelabos
containing all the necessary files to run HomelabOS.
HomelabOS uses Ansible to configure the server. To install Ansible on nixOS, run the following command:
sudo nix-env -i ansible
Before running HomelabOS, you'll need to configure your server. Navigate to the homelabos
directory and open the config.yml
file in a text editor:
cd homelabos
nano config.yml
Update the variables in the config.yml
file to match your desired configuration. You can learn more about the configuration options in HomelabOS here.
Now that your server is configured, you can run HomelabOS. To do so, run the following command:
ansible-playbook homelabos.yml
HomelabOS will now run through the installation process. This may take some time, depending on the resources available to your server.
Congratulations! You have successfully set up HomelabOS on nixOS Latest. You can now access your self-hosted services by navigating to your server's IP address in your web browser.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
Alternatively, for the best virtual desktop, try Shells!