AmberChest auf UGREEN NAS installieren

Diese Anleitung installiert AmberChest mit der Docker-App von UGOS Pro auf einer UGREEN-NAS. Am Ende läuft die Weboberfläche auf Port 8484, und deine IMAP-Postfächer werden automatisch als .eml-Dateien gesichert. Die Schritte folgen der UGREEN-Dokumentation für UGOS Pro ab Firmware 1.19.1.0126; ältere Versionen können abweichende Menüs haben. Je nach Version können Bezeichnungen leicht abweichen.

Vorbereitung

Docker-App installieren

1. Öffne das „App Center“.
2. Suche nach „Docker“.
3. Klicke auf „Installieren“ und durchlaufe den Assistenten.
4. Öffne die App „Docker“.

UGREEN rät davon ab, die Docker-App auf ARM-Geräten mit 4 GB Arbeitsspeicher oder weniger zu installieren, weil Leistung und Stabilität leiden können. AmberChest enthält zusätzlich Chromium und ist nicht klein.

Falls das Herunterladen von Images später fehlschlägt oder sehr langsam ist, trägst du einen Registry-Mirror ein: In der Docker-App unter „Image“ oben auf „Einstellungen“, dann Tab „Image-Repository“, „Registrierungseinstellungen“. Das ist nur bei Problemen nötig.

Installation

UGOS legt beim Anlegen eines Projekts automatisch einen Ordner mit dem Projektnamen im freigegebenen Ordner docker an. Die Compose-Datei unten nutzt Unterordner dieses Projektordners (./config und ./archive), die Docker beim Start selbst erzeugt.

1. Öffne in der Docker-App die Seite „Projekt“.
2. Klicke auf „Erstellen“.
3. Gib bei „Projektname“ amberchest ein.
4. Füge unter „Compose-Konfiguration“ den Inhalt des folgenden Kastens ein.
5. Ersetze in der Datei HIER-MASTER-PASSWORT durch ein eigenes langes Passwort. Es verschlüsselt alle Zugangsdaten deiner Postfächer, und es gibt keine Wiederherstellung – bewahre es an einem sicheren Ort auf
6. Ersetze HIER-PASSWORT-FUER-DIE-OBERFLAECHE durch das Passwort, mit dem du dich später an der Weboberfläche anmeldest

# AmberChest – sichert deine IMAP-Postfächer als .eml-Dateien
services:
  amberchest:
    image: ghcr.io/sphings79/amberchest:latest   # fertiges Image (amd64 und arm64)
    container_name: amberchest
    restart: unless-stopped                      # startet nach einem Neustart des Servers wieder
    ports:
      - "8484:8484"                              # Weboberfläche: http://IP-DES-SERVERS:8484
    volumes:
      - ./config:/config
      - ./archive:/archive
    environment:
      AMBERCHEST_MASTER_PASSWORD: "HIER-MASTER-PASSWORT"             # verschlüsselt deine Zugangsdaten, keine Wiederherstellung!
      AMBERCHEST_UI_PASSWORD: "HIER-PASSWORT-FUER-DIE-OBERFLAECHE"   # Anmeldung an der Weboberfläche
      AMBERCHEST_CRON: "0 3 * * *"               # automatische Sicherung jeden Tag um 03:00 Uhr (Zeile entfernen = nur manuell)
      TZ: Europe/Berlin                          # Zeitzone, nach der sich der Zeitplan richtet

Enthält ein Passwort ein Dollarzeichen, schreibe es in der Compose-Datei doppelt ($$), sonst liest Compose es als Variable. Passwörter mit Sonderzeichen setzt du in Anführungszeichen, wie in der Vorlage. Den Ordner archive kannst du später in „Dateien“ im Projektordner finden. Die Pfade in volumes sind relativ zum Projektordner gedacht; wenn das bei dir nicht greift, hilft der Hinweis unter „Wenn etwas nicht klappt“.

7. Klicke auf „Bereitstellen“.

Das System lädt das Image und erstellt den Container. Das dauert einige Minuten. Danach zeigt die Seite „Projekt“ den Status des Projekts, und unter „Container“ erscheint amberchest als laufend.

Einrichtung in der Weboberfläche

Beim ersten Öffnen verlangt die Oberfläche das Passwort, das du als AMBERCHEST_UI_PASSWORD eingetragen hast. Das Master-Passwort kommt im Container aus der Compose-Datei und wird nicht in der Oberfläche abgefragt. Danach legst du dein erstes Postfach an.

1. Öffne im Browser http://IP-DES-SERVERS:8484 (Platzhalter: die IP-Adresse deines Servers, im Beispiel 192.168.1.50).
2. Gib bei „Anmelden“ das Oberflächen-Passwort ein und klicke auf „Anmelden“.
3. Klicke in der Seitenleiste auf „Konto hinzufügen“.
4. Trage bei „Anzeigename“ eine Bezeichnung ein, zum Beispiel „Privat“.
5. Trage bei „E-Mail-Adresse“ deine Adresse ein.
6. Trage bei „Server“ den IMAP-Server deines Anbieters ein (steht in der Hilfe deines Mailanbieters, meist so ähnlich wie imap.anbieter.de).
7. Wähle bei „Verschlüsselung“ „SSL/TLS (993)“, sofern dein Anbieter nichts anderes vorgibt.
8. Trage „Benutzername“ und „Passwort“ deines Postfachs ein.
9. Klicke auf „Verbindung testen“.

Bei Erfolg erscheint „Verbindung erfolgreich“ und die Zahl der gefundenen Ordner. Bei Fehlern stimmt meist Server, Port oder Passwort nicht. Gmail und Microsoft 365 nehmen für IMAP kein normales Passwort mehr an; für sie gibt es die Anmeldeart OAuth, die in der Projektdokumentation beschrieben ist.

10. Klicke auf „Speichern“.
11. Wähle im Dialog „Ordner auswählen“ die Ordner, die gesichert werden sollen. Papierkorb, Spam und Entwürfe sind zunächst abgewählt.
12. Klicke auf „Speichern und sichern“.

Jetzt läuft die erste Sicherung. Der Fortschritt erscheint live in der Oberfläche; bei großen Postfächern dauert sie entsprechend lange. Auf dem Server wird nichts gelöscht und nichts als gelesen markiert. Ab jetzt sichert AmberChest nach dem Zeitplan aus AMBERCHEST_CRON automatisch, im Beispiel täglich um 03:00 Uhr.

Kontrolle

1. Öffne in der Docker-App die Seite „Container“.
2. Klicke auf den Container amberchest.
3. Wechsle zum Reiter „Protokoll“ (englisch „Log“).

Der Container hat den Status „Running“, im Protokoll stehen Startmeldungen ohne Fehler. Nach der ersten Sicherung liegt im Archivordner ein Verzeichnis pro Postfach. Pro Postfach legt AmberChest im Archivordner ein Verzeichnis an, darin liegt jede Nachricht als eigene .eml-Datei im Ordnerbaum des Postfachs. Die Dateien lassen sich mit Thunderbird, Apple Mail oder Outlook öffnen.

Updates

Einstellungen und Archiv liegen in Ordnern auf dem NAS und bleiben beim Update erhalten. Schalte zuerst die Updateerkennung ein: In der Docker-App unter „Verwaltung“ aktivierst du die „Updateerkennung“ (optional mit Zeitplan). Gibt es eine neue Version, erscheint ein Hinweis in der Liste.

1. Öffne die Seite „Projekt“.
2. Wähle das Projekt amberchest und klicke auf „Update“.

UGREEN beschreibt, dass dabei die neuesten Images geladen und das Projekt neu aufgebaut wird, mit kurzer Unterbrechung des Dienstes. Die genaue Position der Schaltfläche kann je nach Version abweichen.

Wenn etwas nicht klappt

• Die Seite lädt nicht: Prüfe, ob der Container „Running“ ist, und ob die Adresse http://IP-DES-NAS:8484 stimmt. Der NAS-Port darf nicht schon belegt sein; ändere sonst "8484:8484" zu "8485:8484".
• Der Container startet nicht: Die UGREEN-Dokumentation empfiehlt, zuerst das Container-Protokoll zu prüfen (Ports, Rechte, Pfade, Umgebungsvariablen).
• Der Ordner config oder archive entsteht nicht oder bleibt leer: Lege die Ordner in „Dateien“ vorab an und trage in der Compose-Konfiguration ihren vollständigen Pfad ein.
• Der Download des Images dauert ewig oder scheitert: Trage wie oben beschrieben einen Registry-Mirror ein. Ob der Mirror für ghcr.io greift, ist nicht dokumentiert; sonst hilft eine bessere Verbindung.
• Master-Passwort vergessen: Es gibt keine Wiederherstellung; bereits gesicherte .eml-Dateien bleiben lesbar.
• „Verbindung testen“ schlägt fehl: Prüfe Server, Port, Verschlüsselung und ob dein Anbieter ein App-Passwort für IMAP verlangt.