UniFi OS Server: Migration auf Container-Architektur mit GlennR

|

1. Einleitung

Der klassische UniFi Network Server als reine Java-Applikation wird zunehmend durch den containerisierten UniFi OS Server ersetzt. Stand Februar 2026 bietet diese Architektur mehr Sicherheit und Zugriff auf moderne Features wie Site Magic SD-WAN. Dieses Tutorial zeigt die Migration auf einem Linux-Server mithilfe des Skripts von Glenn R.

  • Zielgruppe: Administratoren von Self-Hosted UniFi-Umgebungen (VPS, Raspberry Pi, Bare Metal).
  • Voraussetzung: Linux-Server (z. B. Ubuntu 24.04, Debian 12/13) mit SSH-Zugriff.
  • Voraussetzung: Manuelles Backup (.unf-Datei) zwingend vorhanden.
  • Hardware: Mindestens 4 GB RAM empfohlen.

2. Überblick

Nach Abschluss dieses Tutorials läuft Ihr UniFi-Controller in einer isolierten «Rootless»-Container-Umgebung. Das Ergebnis bietet:

  • Automatische Einrichtung des neuen System-Users «uosserver».
  • Migration bestehender Daten (sofern möglich).
  • Erhöhte Sicherheit durch Trennung vom Host-Betriebssystem.

3. Schritt-für-Schritt Anleitung

Schritt 1: Systemvorbereitung

Verbinden Sie sich via SSH mit Ihrem Server und aktualisieren Sie die Paketquellen, um Konflikte zu vermeiden.

sudo apt-get update && sudo apt-get upgrade -y

Schritt 2: Notwendige Tools installieren

Das Installationsskript benötigt curl und aktuelle CA-Zertifikate, um die Daten sicher herunterladen zu können.

sudo apt-get install ca-certificates curl -y

Schritt 3: Migration durchführen

Führen Sie das aktuelle Installationsskript aus. Es erkennt automatisch bestehende Installationen, stoppt alte Java-Dienste und migriert die Umgebung in einen Rootless-Container unter dem Benutzer uosserver.

curl -sO https://get.glennr.nl/unifi/install/install_latest/unifi-latest.sh && bash unifi-latest.sh

Bestätigen Sie während des Prozesses die Frage nach der Datenmigration mit «Yes».

Schritt 4: Container-Status prüfen

Da der Dienst nicht mehr als Root läuft, zeigen Standardbefehle keine Container an. Prüfen Sie den Status explizit unter dem neuen Benutzerkontext:

cd /tmp && sudo -u uosserver podman ps

Der Status muss als «healthy» angezeigt werden.

4. Wichtige Hinweise & Stolperfallen

Port-Änderung: Die Administrationsoberfläche ist nach der Umstellung unter https://deine-ip:11443 erreichbar.

Datenpfade: Die Anwendungsdaten liegen nun im Verzeichnis /home/uosserver/.local/share/containers/ und nicht mehr in den alten Systempfaden.

5. Ergebnis & Fazit

Sie haben Ihr System erfolgreich auf den UniFi OS Server aktualisiert. Durch die Containerisierung ist die Abhängigkeit von spezifischen Java-Versionen auf dem Host-System eliminiert. Sollte die automatische Migration der Einstellungen fehlgeschlagen sein, können Sie nun Ihr Backup über die neue Web-Oberfläche einspielen.