Deploying HomelabOS on a Raspberry Pi 4
HomelabOS is a tool for deploying self-hosted services on a server. For this installation, you will need:
- Raspberry Imager
ubuntu-preinstalled-server-arm64from here: https://github.com/TheRemote/Ubuntu-Server-raspi4-unofficial/releases
- Docker on your PC (your user should be in the
sudo usermod -a -G docker username)
- Latest HomelabOS zip from here: https://gitlab.com/NickBusey/HomelabOS/-/tags
We will need Ubuntu 18.04 on the Raspberry. Here’s how to install it.
First, open up Raspberry Imager and flash Raspbian to your SD card. Boot up your RPi 4 and run these commands:
sudo apt-get update && sudo apt-get dist-upgrade -y sudo rpi-update sudo rpi-eeprom-update -a
Actually installing Ubuntu
Now, use Raspbian Imager to flash the IMG file for Ubuntu Server 18.04 to your SD card. Boot up your Raspberry and check for working SSH (default user and password are
ubuntu). You will need to configure an SSH key if you don’t have one, so
ssh-copy-id are your friends. A static IP would also be convenient, you can use netplan to configure it, it’s easy!
Extract files from the downloaded ZIP on your PC. Now
cd to the HomelabOS directory and run the following:
make logo make config # answer some questions make set enable_miniflux true # miniflux is a feed reader make
This should accomplish the following steps:
- Build Docker images for HomelabOS
- Set some configuration variables and create
- Enable a service, it doesn’t have to be miniflux, I chose that for testing
- Deploy the configured services to your Raspberry
For more info and troubleshooting, see the original posts.
- Ubuntu 18.04.4 unofficial image: https://jamesachambers.com/raspberry-pi-4-ubuntu-server-desktop-18-04-3-image-unofficial/
- HomelabOS installation: https://nickbusey.gitlab.io/HomelabOS/setup/installation/
I’ll be updating this post with more info and tips as I continue optimizing my configuration.