# UniFi Network Application (Docker)

UniFi Network Application (Controller) mit MongoDB, alle persistenten Daten
liegen im Projektordner unter `./data/`.

- Image: [linuxserver/unifi-network-application](https://docs.linuxserver.io/images/docker-unifi-network-application/)
- Datenbank: MongoDB **4.4** (bewusst — die CPU dieses Rechners hat kein AVX,
  MongoDB 5+ würde nicht starten. Nicht auf ein neueres Mongo-Image wechseln!)

## Erster Start

```bash
docker-compose up -d
docker-compose logs -f unifi-network-application   # warten bis der Start durch ist
```

Danach im Browser: **https://<host-ip>:8443** (selbstsigniertes Zertifikat,
Warnung einmalig bestätigen). Im Einrichtungs-Assistenten kann auch direkt ein
vorhandenes Backup (`.unf`) eingespielt werden.

## Wichtig: Inform-Port ist 8082 (nicht 8080!)

Port 8080 ist auf diesem Host bereits belegt, deshalb lauscht der
Inform-Port für die Geräte-Adoption auf **8082**. Damit Geräte sich melden:

- In der Weboberfläche: *Einstellungen → System → Erweitert →
  "Inform Host" überschreiben* aktivieren und `<host-ip>:8082` eintragen, **oder**
- pro Gerät per SSH: `set-inform http://<host-ip>:8082/inform`

## Ports

| Host-Port | Zweck                                    |
|-----------|------------------------------------------|
| 8443      | Weboberfläche (HTTPS)                    |
| 8082      | Inform / Geräte-Adoption (→ 8080 intern) |
| 3478/udp  | STUN                                     |
| 10001/udp | Geräte-Discovery                         |
| 8843      | Gäste-Portal HTTPS (optional)            |
| 8880      | Gäste-Portal HTTP (optional)             |
| 6789      | Mobile Speedtest (optional)              |

## Aktualisieren

```bash
./update.sh
```

Erstellt zuerst ein Backup, zieht dann die neuesten Images und startet die
Container neu. Alle Daten bleiben in `./data/` erhalten.

## Backups

```bash
./backup.sh          # kopiert die UniFi-Autobackups (.unf) nach ./backups/
./backup.sh --full   # Komplett-Backup von ./data als tar.gz (kurze Downtime)
```

Autobackups einmalig in der Weboberfläche aktivieren:
*Einstellungen → System → Backups → Automatische Sicherung*.

## Wiederherstellen

```bash
./restore.sh backups/unifi-full-backup_<datum>.tar.gz   # Komplett-Restore
./restore.sh backups/autobackup_<datum>/<datei>.unf     # .unf bereitstellen
```

`.unf`-Backups werden anschließend in der Weboberfläche eingespielt
(*Einstellungen → System → Backups → Wiederherstellen*) oder bei einer
Neuinstallation direkt im Einrichtungs-Assistenten.

## Verzeichnisstruktur

```
data/mongodb/   MongoDB-Datenbank
data/unifi/     UniFi-Konfiguration, Logs, Autobackups
backups/        von backup.sh erstellte Sicherungen
.env            Zugangsdaten der Datenbank (nicht weitergeben)
```