Friday, March 27, 2026

Install UniFi OS Server 5.0.6 on Debian 13 (x64)

Here's how I installed UniFi OS Server 5.0.6 on Debian (x64) on Debian 13.  

I used Podman on Debian (Debian' version of Docker).  It just made everything work.  
The version of Debian was debian-13.4.0-amd64-netinst
The install file from Unifi used at time of writing was 1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64  You can substitute this file name for a new one assuming new ones will exist

A very "Next Next OK" install where the basic settings were used. 

The only addition to the base install was adding the SSH server component.


(Enter root)
su

sudo apt update

sudo apt install -y podman uidmap slirp4netns iptables curl wget ca-certificates

Download the install file from Unifi. 

Obtain the link from Unifi's web site (Software Downloads - Ubiquiti).  This will ensure you get the latest version.  Right clicking on the download link will let you copy the link name.


wget https://fw-download.ubnt.com/data/unifi-os-server/1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64

Create a directory for the this install to be placed in
sudo mkdir -p /usr/local/src/unifiserver

Move the file from the file location you are in now to the new directory location
mv 1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64 /usr/local/src/unifiserver/

go to the directory
cd /usr/local/src/unifiserver


Make dwonloaded file executable
chmod +x 1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64

example: chmod +x 
1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64

Run the file

./1856-linux-x64-5.0.6-33f4990f-6c68-4e72-9d9c-477496c22450.6-x64

You will be prompted to install, so y for yes


After the install is completed, you should see something like this that indicates it was successful install.

UOS Server is running at: https://IP_ADDRESS:11443/

These two commands will make sure everything starts up

sudo systemctl enable --now uosserver

sudo systemctl status uosserver


You should be ready to go.  Https to your box and logon

"Proceed" through this alert.  Its normal


Give it a name
This install we are not using a UI account

Continue Anyway

Give it a password.  Acknowledge the terms and services and click FINISH
Base configs are setting up.  After a few seconds you'll be prompted to click "Go to Dashboard"
Unifi Installed















No comments:

Post a Comment

Feel free to leave a comment! If you have any information that you think should be included, please do so here and I'll get it added in.