I wanted to repurpose my old Raspberry Pi 2 into something useful, as its age is showing and can’t be used for anything complicated these days. One of the things it can do just fine is manage a small home or office Ubiquiti-based network.
I’ve already written about setting up a Raspberry Pi, and while that guide is quite old it still holds true, just with newer versions of everything (e.g.
release=buster instead of
Let’s get right into it.
Before we do anything, make sure we’re all up to date on software:
With that out of the way, the first thing we need to do is install a newer Java runtime than the default, as the Oracle version available in the default repositories is too old for the Unifi software.
We’ll also want to install something to speed up any actions that require randomness, as a Raspberry Pi can’t generate entropy fast enough because it has no mouse or keyboard to generate it from.
Getting right into it, we’ll add the Ubiquiti repositories and add their GPG keys for verifiying the package signatures.
We can now finally install the Unifi Controller Software:
After everything is installed, the Unifi software should be running automatically, and you’ll be able to visit it at
Bonus: Reverse proxy
We’ll want to visit the webgui on a standard port like
443 instead of
8443, and also get valid certificates to boot!
For this we’ll use the fantastic software Caddy, which recently had its 2nd major release.
As with the Unifi software we’ll need to add their repositories first.
With that in place we can install Caddy:
To set up Caddy, all we need to do is replace the contents of the configuration file, found at
/etc/caddy/Caddyfile using your favorite terminal editor (e.g.
Then restart the Caddy service and it should work: