HomelabOS is a home server automation platform that allows you to easily install, manage and maintain various services for your home network. In this tutorial, we'll go through the steps of installing HomelabOS on Fedora CoreOS, the minimal operating system optimized for running containerized workloads.
Open a terminal and connect to your Fedora CoreOS server via SSH. You can use your preferred SSH client, such as OpenSSH or PuTTY.
ssh <username>@<server_ip>
If this is your first time connecting, you'll need to confirm the authenticity of the host.
Clone the HomelabOS repository from GitHub onto your server.
git clone https://github.com/NickKaramoff/homelabos.git
Navigate to the HomelabOS directory and create a configuration file for your installation.
cd homelabos
cp .env.sample .env
Edit the .env file to include your desired settings, such as the domain name, administrator email, and service credentials. You can use nano or vim text editor to modify the file.
nano .env
Once you're done editing, save the file and close the editor.
Run the install.sh script to install HomelabOS and its dependencies. This script will install necessary software packages, initialize the database, and build Docker containers for each service.
./install.sh
The installation process can take several minutes depending on your internet connection and server performance.
After the installation is completed successfully, you can access the HomelabOS dashboard by opening a web browser and navigating to your server's domain name or IP address.
https://<server_ip>
You'll be prompted to log in with your administrator credentials that you defined in the .env file earlier. Once you're logged in, you can start configuring and using the installed services, such as Nextcloud, Gitea, and Bitwarden.
HomelabOS provides an excellent way to automate and streamline the installation of various services for your home network. By following this tutorial, you've learned how to install HomelabOS on Fedora CoreOS and start using its features. Don't hesitate to experiment with other services and configurations that suit your specific needs.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
Alternatively, for the best virtual desktop, try Shells!
