There are a number of UniFi Docker images out there, but I like the one by jacobalberty as it’s kept up to date – plus it exposes a volume for adding trusted certificates.
Install Docker and related tools: UniFi Controller Install Unifi Controller Docker Mac
Here’s the tl dr version of the installation instructions, but if you want to read the full version with all the details – check the Docker website.Ĭonfigure the Docker repository – it contains a more up-to-date version: Pay attention to the UID and GID that get created you need them in the Docker Compose file below. This will also affect what ports you can configure the controller to use – the default ports work fine for any user, but changing any of the ports to <1024 requires root.Ĭreate the unifi user and group accounts: UniFi probably shouldn’t be run as root – this is generally a good idea, plus it may also become a requirement for the Docker image I’m using in the future. I’ve made some assumptions about what’s needed – you may need to customise things a little more: User Account Run the following four commands to configure and enable the firewall. I use ufw to configure iptables – first, set up an application definition for the UniFi Controller – in /etc/ufw/applications.d/unifi: HTTP – required for the HTTP-01 challenge type Let’s Encrypt also needs a port open: Port Speed Test – only needed if you use the speed test feature GUI – required even if you use the Cloud Controller accessĬaptive Portal – HTTP – only needed if you use the captive portal featureĬaptive Portal – HTTPS – only needed if you use the captive portal feature STUN – required for device communication with the controller Here’s the official list – it differs slightly to what I use: Port UniFi needs a bunch of inbound ports open. You’ll also need a fixed public IP and functional DNS to get an SSL certificate. Note: this guide assumes you’re configuring things on a server or VM with public Internet access.
I hope that this blog post is helpful for you and see you next time.Ī slight change of plans from earlierposts on the topic of UniFi Controllers! Here’s how to get a UniFi Controller running inside a Docker container, along with a trusted Let’s Encrypt SSL certificate. Go to your Controller website and you will see some welcome screens. Go to Registry and search for the jacobalberty/unifi image and download this imageĪfter the image is downloaded, stop the container with the controllerĪfter the container is stopped, click “Actions” and then “Clear”
The blogpost about to setup the controller in Docker, can you find here.Īre you ready? Yes? Follow the steps below to update your Unifi Controller on Docker.
Stability, Performance and Security Updates But in the upper right corner there was a pop-up saying that there was a new version available for download.Ģ. But today I have some time for it.Ī couple of weeks ago I logged in my Unifi Controller, which is running in Docker on my Synology DS918+, to do some network changes.