Anleitung

1. Einleitung

Der UniFi Controller ist das Herzstück jedes UniFi-Netzwerks. Lange Zeit bot Ubiquiti dafür den “Cloud Key” an - eine kleine Hardware-Box für etwa 150€, die den Controller hostet. Doch es geht günstiger und flexibler: Deine Synology NAS ist der perfekte Ort dafür!

Warum die Synology?

• Ein NAS läuft sowieso 24/7
• Keine extra Hardware nötig (erspart ~150€)
• Docker macht Installation und Updates einfach
• Zentraler Zugriff auf alle Controller-Features

In diesem Tutorial zeige ich dir, wie du die UniFi Network Application (so heißt der Controller mittlerweile offiziell) auf deiner Synology DS224+ installierst - mit Docker Compose, versteht sich!

---

2. Das RAM-Problem verstehen

Bevor wir starten, must du eines wissen: Der UniFi Controller ist kein Leichtgewicht.

Warum ist so viel RAM nötig?

Der Controller basiert auf Java und bringt eine eigene MongoDB-Datenbank mit. Das macht ihn relativ “hungrig” nach Arbeitsspeicher.

Das Problem bei der DS224+:

• Werkseitig: Nur 2 GB RAM
• Betriebssystem + DSM: ~1 GB
• Controller startet: 2 GB voll
• Ergebnis: Das NAS beginnt zu swappen (Auslagerung auf die Festplatte)
• Konsequenz: System wird extrem langsam, Festplatten rattern

Die Lösung: RAM aufrüsten!

---

3. RAM aufrüsten

4. Welcher RAM?

Die DS224+ nutzt DDR4 SO-DIMM Module. Ein 4 GB Riegel reicht für den Anfang völlig.

• Empfehlung: 4 GB DDR4 SO-DIMM (~20-30€)
• Zukunft: 8 GB wenn du später mehr Container planst

5. Schritt-für-Schritt Einbau

1. NAS ausschalten und Stromkabel abziehen
2. Festplatteneinschübe vorne ziehen (einfach herausnehmen)
3. RAM-Slot finden (an der Innenseite des Gehäuses)
4. Neuen Riegel einklicken - genau wie bei einem Laptop
5. Einschübe zurück und NAS starten

Tipp: Synology bietet auch offizielle RAM-Kits an, aber günstige Drittanbieter funktionieren genauso gut.

---

6. Docker auf der Synology einrichten

7. Container Manager installieren

1. Öffne die Paketverwaltung (Package Center)
2. Suche nach “Container Manager”
3. Installiere das Paket (ehemals “Docker”)

8. Projekt erstellen

1. Öffne den Container Manager
2. Gehe auf Projekt
3. Klicke auf Neu erstellen
4. Projektname: unifi-controller
5. Repository: Benötigen wir vorerst nicht (wir nutzen docker-compose.yml)

---

9. Docker Compose Konfiguration

Hier ist die vollständige Konfiguration. Erstelle eine Datei namens docker-compose.yml:

version: '3.8'

services:
  unifi-controller:
    image: lscr.io/linuxserver/unifi-network-application:latest
    container_name: unifi-controller
    environment:
      - PUID=1000
      - PGID=100
      - TZ=Europe/Berlin
      - MEM_LIMIT=1024M
      - MEM_START_LIMIT=512M
    volumes:
      - ./data:/config
    ports:
      - "8080:8080"     # UniFi HTTP
      - "8443:8443"     # UniFi HTTPS
      - "3478:3478/udp"  # STUN
      - "8843:8843"     # HTTPS Redirect
      - "8883:8883"     # HTTP Redirect
    restart: unless-stopped

10. Erklärung der Einstellungen

Einstellung	Bedeutung
PUID/PGID	Benutzer-ID für Dateizugriff (1000 = admin)
TZ	Zeitzone
MEM_LIMIT	RAM-Limit für den Container
MEM_START_LIMIT	Mindestens verfügbares RAM
./data	Persistenzordner (bleibt nach Neustart)

11. Wichtige Ports

Port	Protokoll	Verwendung
8080	TCP	UniFi HTTP (Setup)
8443	TCP	UniFi HTTPS (Controller)
3478	UDP	STUN (Fernzugriff)
8843	TCP	HTTPS Redirect
8883	TCP	HTTP Redirect

12. Docker Compose starten

1. Erstelle den Ordner unifi-controller auf deiner NAS
2. Speichere die docker-compose.yml darin
3. Im Container Manager: Projekt → Neu erstellen
4. Wähle den Ordner aus
5. Klicke auf Weiter und dann Erstellen

Der Download des Images dauert je nach Internetverbindung einige Minuten.

---

13. Ersteinrichtung des Controllers

14. Erster Zugriff

Nach dem Start (dauert 2-3 Minuten):

1. Öffne im Browser: https://deine-nas-ip:8443
2. Akzeptiere das SSL-Zertifikat (Selbstsigniert)
3. Der Einrichtungsassistent startet

15. Einrichtungassistent

1. Land: Deutschland
2. Namen vergeben: z.B. “Home-Netzwerk”
3. Cloud-Zugang: Optional aktivieren (für UniFi App)
4. Gerät suchen: Deine UniFi-Geräte sollten erscheinen
5. Adoptieren: Klicke auf jedes Gerät und dann “Adopt”

16. Wichtige Einstellungen

Controller-Name:

• Einprägsam, z.B. “Synology-Controller”

Auto-Backup:

• Aktiviere regelmäßige Backups (Settings → Controller → Backup)

---

17. Zugriff von außen

18. Option 1: DDNS (Dynamische IP)

Falls du keine statische IP hast:

1. Synology: Systemsteuerung → Externer Zugriff → DDNS
2. Kostenlosen Service einrichten (z.B. MyDS)
3. URL merken: deinname.myds.me

19. Option 2: Port-Weiterleitung

Achtung: Nur empfohlen mit starkem Passwort!

1. Router: Port 8443 → IP der Synology
2. Zugriff: https://deine-public-ip:8443

Sicherer: Nur UDP 3478 (STUN) weiterleiten für App-Zugriff

20. Option 3: VPN

Am sichersten: Erst VPN zum Heimnetz, dann auf Controller zugreifen.

---

21. Wartung & Updates

22. Container updaten

1. Container Manager → Projekt
2. Wähle das Projekt
3. Stoppen
4. Backup erstellen (optional aber empfohlen)
5. Neu starten → Image wird automatisch aktualisiert

23. Logs anzeigen

Bei Problemen:

1. Container Manager → Container
2. Wähle “unifi-controller”
3. Aktionen → Details
4. Reiter Log

24. Backup & Restore

Der Controller hat ein eingebautes Backup:

1. Settings → Controller → Backup
2. “Create Backup”
3. Backup-Datei sicher speichern

---

25. Zusammenfassung

Herzlichen Glückwunsch! Du hast jetzt einen professionellen UniFi-Controller auf deiner Synology laufen!

Was du erreicht hast:

• RAM der DS224+ aufgerüstet (4+ GB)
• UniFi Network Application via Docker installiert
• Controller eingerichtet
• Geräte adoptiert

Vorteile deines Setups:

• Kein extra Cloud Key nötig (150€ gespart)
• Zentrale Verwaltung auf dem NAS
• Einfache Backups via Synology
• 24/7 Betrieb ohne Extra-Stromverbrauch

Nächste Schritte (optional):

• Mehr UniFi-Geräte adoptieren
• VLANs einrichten (siehe Tutorial #7)
• Gästewlan konfigurieren (siehe Tutorial #6)

Viel Erfolg mit deinem UniFi-Netzwerk!

---

Dieses Tutorial enthält Affiliate-Links. Als Amazon-Partner verdiene ich an qualifizierten Käufen.