How to install HomelabOS on Manjaro

HomelabOS is a collection of Ansible scripts that help automate the setup of a home server with a variety of useful self-hosted applications. This tutorial will guide you through the process of installing HomelabOS on a Manjaro system.

Prerequisites

  • Manjaro Linux installed on your system
  • A user account with sudo privileges
  • Git installed on your system

Step 1: Clone the HomelabOS repository

  1. Open a terminal window on your Manjaro system
  2. Change to your home directory by typing cd ~
  3. Clone the HomelabOS repository by typing git clone https://github.com/homelab-os/homelab-os.git

Step 2: Install Ansible

  1. Open a terminal window on your Manjaro system
  2. Update the package list by typing sudo pacman -Syu
  3. Install Ansible by typing sudo pacman -S ansible

Step 3: Configure HomelabOS

  1. Navigate to the homelab-os directory that was cloned in Step 1 by typing cd ~/homelab-os
  2. Copy the example configuration file by typing cp .env.example .env
  3. Open the .env file in a text editor of your choice and configure the values to match your desired setup. Be sure to set the USER_PASSWORD variable to a strong password.
  4. Save and close the .env file.

Step 4: Run HomelabOS

  1. Navigate to the homelab-os directory that was cloned in Step 1 by typing cd ~/homelab-os
  2. Run the HomelabOS setup script by typing ./setup.sh
  3. Follow the prompts to complete the setup process. This may take some time and involve some user interaction.
  4. Once the setup process is complete, you should have a fully functional HomelabOS installation.

Congratulations, you have successfully installed HomelabOS on Manjaro Linux! You can now access your self-hosted applications by navigating to http://<your_ip_address> in your web browser.