How to Install HomelabOS on Debian Latest

In this tutorial, we will guide you through the process of installing HomelabOS on Debian Latest.

Prerequisites

Before installation, you'll need to:

  • GatsbyJS installed on your machine
  • Git installed on your machine
  • Existing Debian Latest with sudo access

Step 1: Clone HomelabOS Repository

The first step is to clone the HomelabOS repository on your Debian Latest system. You can do that by running the following command:

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

Step 2: Install HomelabOS Dependencies

Now, we need to install the dependencies required for HomelabOS installation. You can do that by running the following command:

sudo apt install ansible bash curl git gnupg2 make nano nginx-full python3-httplib2 python3-pip python3-requests python3-six python3-wheel python3-yaml

Step 3: Configure HomelabOS

Next, you need to navigate to your HomelabOS directory and configure HomelabOS by typing the following command:

cd homelabos/
cp env.example .env
nano .env

In the .env file, you must configure the following information:

  • Please make sure to fill in the SITE_FQDN field
  • add the email address you wish to use for ssl certificates into SSL_EMAIL

Step 4: Launch HomelabOS

Once the configuration is complete, you can launch HomelabOS by running the following command:

sudo make

This may take a while, so be patient.

Step 5: Access Your HomelabOS Site

Once the installation process is completed successfully, you can access your HomelabOS site by navigating to the FQDN you set up in step 3.

Conclusion

Congratulations! You have successfully installed HomelabOS on Debian Latest! You can now explore the various applications included in HomelabOS for managing your Homelab.