How to Install HomelabOS on Arch Linux

HomelabOS is a collection of Ansible playbooks that automate the setup of a homelab environment. In this tutorial, we will guide you through the steps of installing HomelabOS on Arch Linux.

Prerequisites

Before we begin with the installation process, ensure that you have the following prerequisites:

  • A running Arch Linux system
  • A user with sudo privileges
  • Ansible 2.10 or higher

Steps to Install HomelabOS on Arch Linux

Follow these steps to install HomelabOS on Arch Linux:

Step 1: Clone the HomelabOS repository

To clone the HomelabOS repository, open the terminal and run the following command:

git clone https://gitlab.com/NickBusey/HomelabOS.git

Step 2: Install HomelabOS dependencies

To install HomelabOS dependencies, run the following command:

sudo pacman -S python python-pip

Step 3: Install Ansible

HomelabOS uses Ansible to automate the setup of the environment. If you have not installed Ansible earlier, execute the following command to install it:

sudo pacman -S ansible

Step 4: Configure inventory file

Navigate to the HomelabOS directory that you cloned in Step 1. Then, rename the "inventory-example" file to "inventory" using the following command:

mv inventory-example inventory

Now, edit the "inventory" file according to your needs. This file contains a list of hosts and variables that Ansible uses to configure the homelab environment.

Step 5: Install required roles

HomelabOS requires several roles to execute correctly. To install these roles, run the following command:

sudo ansible-galaxy install -r requirements.yml

Step 6: Run the playbook

Now, you can run the HomelabOS playbook. To do so, execute the following command:

ansible-playbook -i inventory site.yml

Ansible will run the HomelabOS playbook, and you should see the output of the playbook execution.

Congratulations, you have successfully installed HomelabOS on Arch Linux.

Conclusion

In this tutorial, we covered the installation process of HomelabOS on Arch Linux. With HomelabOS, you can automate the setup of your homelab environment and save time. We hope that this tutorial has helped you install HomelabOS effortlessly.