How to Install HomelabOS on FreeBSD Latest

HomelabOS is a free and open source self-hosted web application platform that makes it easy to deploy and manage various services such as email, file sharing, and media streaming. This tutorial will guide you through the installation of HomelabOS on FreeBSD Latest.

Prerequisites

Before beginning the installation process, you will need:

  • Root access to a FreeBSD Latest server
  • SSH access to your server
  • Basic knowledge of the command line.
  • Git command line tool

Step 1: Install Docker and Docker Compose

HomelabOS relies on Docker and Docker Compose to create and manage containers. To install them, you can use the following commands:

pkg install docker
pkg install docker-compose

Step 2: Clone the HomelabOS repository

You must first clone the HomelabOS repository to your server's file system. To do so execute the following command:

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

Note that you can change "/root/homelabos" to any path you prefer.

Step 3: Launch the Installer

To start the installer, navigate to the HomelabOS directory using the following command:

 cd /root/homelabos

Next, execute the installer script using the following command:

./homelabos.sh

Step 4: Follow the Installer's Prompts

The HomelabOS installer will guide you through the necessary steps to deploy the platform on your server.

First, the installer will prompt you to select a subdomain for accessing HomelabOS services. You should enter a hostname or subdomain that points to the IP address of your server on the public internet.

Next select the menu item "Install HomelabOS"

The installer will start by checking for any available updates. Then it will ask you to select the services you wish to deploy.

Once you have selected the services you want, the installer will begin downloading and configuring the appropriate containers. Depending on the services you have chosen, the process can take several minutes.

After the process is complete, the installer will ask you to create a user account to access the HomelabOS dashboard. Follow the prompts to create your account and complete the process.

Step 5: Accessing HomelabOS Dashboard

You can now access the HomelabOS dashboard by navigating to your subdomain in your web browser. Enter your newly created user credentials to sign in and start using the deployed services.

Congratulations! You have successfully installed HomelabOS on FreeBSD Latest.