Unraid kann Docker Compose von Haus aus nicht. Deshalb nutzt diese Anleitung das Plugin „Compose Manager Plus“ aus den Community Applications: Du fügst die Compose-Datei in einem Formular ein und startest sie mit einem Klick. Am Ende läuft AmberChest auf Port 8484 deines Unraid-Servers und sichert deine IMAP-Postfächer als .eml-Dateien. Die Unraid-Oberfläche ist englisch, deshalb stehen die Bezeichnungen hier auf Englisch.

Vorbereitung

Öffne die Unraid-Weboberfläche und gehe zum Reiter „Main“. Das Array muss gestartet sein.
Gehe zu „Settings › Docker“.
Stelle „Enable Docker“ auf „Yes“, falls es nicht schon so steht.
Klicke auf „Apply“.

Danach erscheint in der Hauptnavigation der Reiter „Docker“. Lass alle weiteren Felder auf den Voreinstellungen. Je nach Version können Bezeichnungen leicht abweichen.

Compose Manager Plus installieren

Öffne den Reiter „Apps“. Fehlt er, installiere zuerst das Plugin „Community Applications“, wie auf der Seite docs.unraid.net/community-applications beschrieben.
Gib im Suchfeld „Compose Manager Plus“ ein.
Klicke bei „Compose Manager Plus“ (nicht der Beta-Version) auf „Install“.
Lass das Installationsfenster geöffnet, bis es fertig ist.

Das ältere Plugin „Docker Compose Manager“ gilt als veraltet; nimm das Plus-Plugin. Nach der Installation gibt es unter „Docker“ den Bereich „Compose“.

Speicherorte festlegen

AmberChest braucht zwei Ordner: config für die verschlüsselten Einstellungen und den Suchindex, archive für die gesicherten Mails. Die Anleitung legt die Einstellungen in die Freigabe appdata und die Mails in /mnt/user/backup/mail. Hast du keine Freigabe namens backup, ersetze in der Compose-Datei backup durch den Namen einer vorhandenen Freigabe (siehe Reiter „Shares“). Fehlende Ordner legt Docker selbst an. Auf Unraid schreibst du die Pfade immer absolut aus (/mnt/user/…), weil der Compose-Projektordner des Plugins auf dem USB-Stick liegt.

Installation

Gehe zu „Docker“ und dort zum Bereich „Compose“.
Klicke auf „Add Stack“.
Gib als Namen amberchest ein.
Bestätige das Anlegen. Der Editor für den Stack öffnet sich.

Im Editor gibt es Reiter wie „Compose“ und „ENV“. Du arbeitest im Reiter „Compose“.

Füge im Reiter „Compose“ den Inhalt des folgenden Kastens ein.
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
Ersetze HIER-PASSWORT-FUER-DIE-OBERFLAECHE durch das Passwort, mit dem du dich später an der Weboberfläche anmeldest
Speichere mit Strg+S.

# 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:
      - /mnt/user/appdata/amberchest:/config
      - /mnt/user/backup/mail:/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
      PUID: "99"                                 # Unraid-Benutzer „nobody“
      PGID: "100"                                # Unraid-Gruppe „users"

Die beiden Zeilen PUID und PGID sorgen dafür, dass die Dateien dem üblichen Unraid-Benutzer „nobody“ gehören. 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.

Klicke beim Stack amberchest auf „Compose Up“.

Unraid lädt das Image und startet den Container. Das Fenster zeigt den Fortschritt; es endet, wenn der Container „Started“ meldet. Der Stack ist mit restart: unless-stopped angelegt und startet nach einem Neustart des Servers wieder mit.

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.

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

Klicke auf „Speichern“.
Wähle im Dialog „Ordner auswählen“ die Ordner, die gesichert werden sollen. Papierkorb, Spam und Entwürfe sind zunächst abgewählt.
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

Gehe zu „Docker“.
Suche den Container amberchest in der Liste.

Das Symbol ist grün, nach einer halben Minute zeigt die Gesundheitsanzeige „healthy“. Ein Klick auf das Symbol öffnet ein Menü, in dem „Logs“ das Protokoll zeigt und „WebUI“ die Oberfläche öffnet (falls der Eintrag fehlt, rufst du die Adresse direkt auf). Beim Compose-Plugin zeigt außerdem „View Logs“ am Stack das laufende Protokoll. Nach der ersten Sicherung liegt im Ordner /mnt/user/backup/mail 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 den Freigaben und bleiben beim Update erhalten.

Gehe zu „Docker“ und zum Bereich „Compose“.
Öffne das Menü beim Stack amberchest (Klick auf das Symbol).
Klicke auf „Update“.

Das Plugin lädt das neue Image und ersetzt den Container. Anschließend sollte der Container wieder grün sein. Meldet das Plugin über „Check for Updates“ keine neue Version, bist du aktuell. Alternativ stellt du im Plugin pro Stack automatische Updates ein. Je nach Version können Bezeichnungen leicht abweichen.

Wenn etwas nicht klappt

Reiter „Apps“ oder „Compose“ fehlt: Installiere zuerst Community Applications und danach Compose Manager Plus; zusätzlich muss „Enable Docker“ auf „Yes“ stehen.
Docker startet nicht: Das Array muss gestartet sein. Danach unter „Settings › Docker“ den Dienst prüfen.
Die Seite lädt nicht: Prüfe, ob der Container läuft, und rufe http://IP-DEINES-UNRAID:8484 auf. Ist Port 8484 belegt, ändere "8484:8484" zu "8485:8484" und öffne Port 8485.
Dateien gehören falschen Benutzern: Setze PUID: "99" und PGID: "100", wie in der Vorlage.
Relative Pfade wie ./config landen im Projektordner des Plugins auf dem USB-Stick: Verwende die absoluten Pfade aus der Vorlage.
Master-Passwort vergessen: Es gibt keine Wiederherstellung; 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.

AmberChest auf Unraid installieren