Step-by-step guide to installing UniFi OS Server on Linux using the official Ubiquiti installer. Compatible with Debian 12/13, Ubuntu 22.04/24.04, and any x64 Linux machine.
Not sure if Linux is the right way to run it? I have put together a list of alternatives like the Cloud Key and Cloud Gateway further down, so you can compare before you start.
Table of Contents
Introduction
If you want to run UniFi OS Server without a Dream Machine or Cloud Gateway, you can install it directly on a Linux machine. This is great for homelabs, virtual machines, or any x64 Linux server you already have running.
In this guide I will show you how to do it step by step, using the official Ubiquiti installer.
What you need
- A Linux machine running one of the following:
- Debian 12 or 13
- Ubuntu 22.04 or 24.04
- Any x64 Linux machine
- Access to the terminal
Step by Step
1. Update your system
Start by making sure your system is fully up to date:
sudo apt update && sudo apt upgrade -y2. Install dependencies
UniFi OS Server requires Podman and slirp4netns. Install them along with curl:
sudo apt-get install podman slirp4netns -y
sudo apt install curl -y3. Download the UniFi OS Server installer
⚠️ The download URL may expire — always check ubnt.com for the latest version.
Use curl to download the installer:
curl -O https://fw-download.ubnt.com/data/unifi-os-server/1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64You can verify the file is there by running ls.
4. Make the file executable
chmod +x 1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x645. Run the installer
sudo ./1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64When prompted, confirm with y and let the installer finish.
6. Access UniFi OS Server
Open your browser and navigate to:
https://YOUR-SERVER-IP:11443Give your server a name, log in, and update the UniFi Network Application when prompted.
UniFi Controller Alternatives
Running UniFi OS Server on Linux is not the only way to manage your network. If you are not sure it is the right fit, here are the main alternatives.
Affiliate Disclosure: As an Amazon Associate I earn from qualifying purchases. The links below are affiliate links — if you buy through them, I may earn a small commission at no extra cost to you.
Cloud Key Gen2 Plus
A small plug-and-play controller from Ubiquiti. You just power it on and connect it to your network, and it runs on its own. No server to maintain. It also has a built-in drive bay if you want to run UniFi Protect for cameras. Good option if you want something simple that just works.
UniFi Cloud Gateway Ultra
A compact device that combines routing and the UniFi controller in one box. Great if you want an all-in-one setup for a home lab or small office without going for a full Dream Machine.
Ubiquiti Cloud Hosting
Ubiquiti also offers a free cloud-hosted controller at unifi.ui.com. No hardware and no server needed. The downside is that you rely on Ubiquiti’s servers, and some features are limited compared to running it yourself.
Why run it on Linux instead?
Installing UniFi OS Server on Linux makes sense if you:
- Already have a server, VM, or NAS running all the time
- Want full control over your setup and data
- Do not want to buy extra hardware
- Run a home lab and want to keep costs down
It is free and flexible, and it runs fine on low-powered hardware. You just have to handle updates and maintenance yourself.
Conclusion
Now you know how to install UniFi OS Server on Linux without a Dream Machine. If you have any questions, don’t hesitate to comment on this post or contact me directly.
I cannot get this to install. I tried on an old desktop and on a virtual machine and neither of them seem to work. I keep getting the following errors:
INFO Waiting for UOS Server to start…
WARN Timeout: Unifi-core did not start within 60 seconds.
WARN
!!! INSTALLATION COMPLETE !!!
To grant permission for a user to run ‘uosserver’ commands:
-> Add the user to the ‘uosserver’ group:
usermod -aG uosserver
-> Then log out and log back in for the changes to take effect.
To get started with available commands, run:
uosserver help
WARNING: UOS Server startup timed out after 60 seconds. On low-powered devices, the web interface can take a few minutes to be accessible. Try opening it at: 192.168.1.100:11443
When I try to access the site I just get a “Secure connection failed” page. Thanks.
Secure Connection Failed
An error occurred during a connection to 100.100.1.100:11443. PR_END_OF_FILE_ERROR
The “unifi-core did not start within 60 seconds” warning is normal — the installer just times out early. The service is still initializing in the background. Wait 3–5 minutes before opening the browser. If it still fails, the most common cause is insufficient RAM; the minimum is 4 GB. Also make sure podman and slirp4netns are installed before running the installer.