Instalace UniFi OS Serveru na Debian 13

Ubiquiti představilo nový způsob, jak provozovat UniFi OS Server na vlastním hardware. Na rozdíl od starších metod (APT balíčky, Docker, komunitní buildy) se nyní používá oficiální instalátor, který nainstaluje UniFi OS Server jako Podman‑based službu.

Tento postup popisuje instalaci na Debian 13 (Trixie), ale funguje i na Debian 12 a Ubuntu 24.04+.

1) Aktualizace systému a instalace Podman

UniFi OS Server vyžaduje Podman a slirp4netns:

sudo apt update && sudo apt dist-upgrade -y
sudo apt install podman slirp4netns -y

Ověření instalace:

podman --version
slirp4netns --version

2) Získání odkazu na instalační soubor

Instalační soubor stáhneš z oficiální stránky:

• Releases https://community.ui.com/releases
• Download page (pravým → „Copy link address“) https://ui.com/download

Odkaz vypadá např.:

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

3) Stažení instalačního souboru

Pomocí curl:

curl -O https://fw-download.ubnt.com/data/unifi-os-server/<verze>

Nebo pomocí wget:

wget https://fw-download.ubnt.com/data/unifi-os-server/<verze>

Po stažení ověř, že soubor existuje:

ls -lh

4) Nastavení spustitelného souboru

chmod +x <soubor_installeru>

Např.:

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

5) Spuštění instalátoru

Instalace proběhne automaticky:

sudo ./<soubor_installeru>

Např.:

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

Instalátor:

• vytvoří adresáře
• stáhne potřebné kontejnery
• nainstaluje systemd službu uosserver
• spustí UniFi OS Server

6) Přístup do webového rozhraní

Po instalaci je UniFi OS Server dostupný na:

https://IP-VAŠEHO-SERVERU:11443

Pokud používáš firewall:

sudo ufw allow 11443/tcp

7) První spuštění

Po otevření webového rozhraní:

1. vytvoříš administrátorský účet
2. přihlásíš se ke svému UI účtu
3. povolíš Remote Management (volitelné)
4. začneš adoptovat zařízení

8) Důležité poznámky

Migrace z UniFi Network Serveru

Pokud migruješ ze starého Network Serveru:

• nejdřív ho vypni, jinak se budou bít porty a tokeny.

Neprováděj klonování VM

Ubiquiti upozorňuje:

Klonované VM budou sdílet stejné remote access tokeny → způsobí to problémy v Site Manageru.

Používej klony jen pro HA / failover.

9) Užitečné příkazy

Zastavení služby

sudo systemctl stop uosserver

Start služby

sudo systemctl start uosserver

Zakázání automatického startu

sudo systemctl disable uosserver

Povolení automatického startu

sudo systemctl enable uosserver

Závěr

Nový Self‑Hosted UniFi OS Server je nejčistší a oficiálně podporovaný způsob, jak provozovat UniFi infrastrukturu na vlastním serveru nebo ve virtualizaci.
Instalace je jednoduchá, stabilní a díky Podmanu dobře izolovaná.
Pokud chceš mít plnou kontrolu nad UniFi prostředím bez UDM nebo Cloud Key, je to ideální volba.