How to install HomelabOS on Void Linux

HomelabOS is a collection of Ansible scripts that automates the installation and management of self-hosted apps.

In this tutorial, we will guide you through the steps to install HomelabOS on Void Linux.

Prerequisites

Before you start, you will need the following:

  • A running instance of Void Linux
  • A user account with sudo privileges

Installation

Step 1: Update system

First, update the system using the following command:

sudo xbps-install -Suy

Step 2: Install Ansible

Next, you'll need to install Ansible. Use the following command to install it:

sudo xbps-install ansible git

Step 3: Download HomelabOS

Clone HomelabOS repository using git:

git clone https://github.com/homelabos/homelabos.git

Step 4: Run HomelabOS

Change into the HomelabOS directory:

cd homelabos

Run HomelabOS using Ansible:

ansible-playbook homelabos.yml -K

You will be prompted for your user password as the -K option enables sudo privileges.

Step 5: Verify Installation

After the installation is complete, you can verify that the applications are successfully installed by visiting the following URLs in your web browser:

  • Home Assistant: http://localhost:8123/
  • Nextcloud: http://localhost:8080/
  • Gitea: http://localhost:3000/

Conclusion

Congratulations! You have successfully installed HomelabOS on your Void Linux system. You can now start exploring the various self-hosted applications that HomelabOS offers to take control of your personal data.