Calibre-Web Automated per Docker installieren¶

Veröffentlicht am 22. August 2026 · Geschätzte Lesezeit: 4 Minuten

Calibre-Web Automated verwaltet E-Books im Browser und übernimmt fertige Dateien aus einem getrennten Eingangsordner automatisch in eine Calibre-Bibliothek. Metadaten, Benutzer und Bücher bleiben auf deinem Server. Für Installation und ersten Import solltest du etwa 25 Minuten einplanen.

Voraussetzungen

Ein Linux-Server mit Docker und Docker Compose
Genügend Speicherplatz für deine E-Book-Bibliothek und Backups
Eine feste IP-Adresse für den Server
Der Port 8083 im Heimnetz frei

1. Arbeitsordner und Benutzerwerte anlegen¶

Erstelle auf dem Docker-Server drei voneinander getrennte Ordner für Konfiguration, Import und Bibliothek:

mkdir -p ~/calibre-web-automated/{config,ingest,library} && cd ~/calibre-web-automated

Erstelle eine .env-Datei mit der Benutzer- und Gruppen-ID deines aktuellen Linux-Benutzers:

printf 'PUID=%s\nPGID=%s\nTZ=Europe/Berlin\n' "$(id -u)" "$(id -g)" > .env

Damit gehören neu angelegte Dateien deinem normalen Serverbenutzer statt root.

2. Compose-Datei erstellen¶

Lege im Ordner ~/calibre-web-automated eine Datei namens compose.yaml an:

services:
  calibre-web-automated:
    image: crocodilestick/calibre-web-automated:latest
    container_name: calibre-web-automated
    restart: unless-stopped
    environment:
      PUID: ${PUID}
      PGID: ${PGID}
      TZ: ${TZ}
      NETWORK_SHARE_MODE: "false"
    volumes:
      - ./config:/config
      - ./ingest:/cwa-book-ingest
      - ./library:/calibre-library
    ports:
      - "8083:8083"

Die drei Bind-Mounts dürfen laut Projektdokumentation nicht ineinander verschachtelt sein. Diese Struktur hält Konfiguration, temporären Import und dauerhafte Bibliothek sauber getrennt.

3. Container starten¶

Starte Calibre-Web Automated im Projektordner:

docker compose up -d

Prüfe anschließend den Zustand:

docker compose ps

Falls die Oberfläche nicht startet, zeigen die letzten Protokollmeldungen den Grund:

docker compose logs --tail=100 calibre-web-automated

4. Standardpasswort sofort ändern¶

Öffne http://<server-ip>:8083 im Browser und ersetze <server-ip> durch die feste IP-Adresse des Docker-Servers. Melde dich einmalig mit dem offiziellen Standardkonto admin und dem Standardpasswort admin123 an.

Ändere das Passwort unmittelbar in den Kontoeinstellungen zu einem langen, einmaligen Passwort. Aktiviere unter Settings → Basic Configuration → Feature Configuration die Upload-Funktion nur, wenn du Bücher über die Weboberfläche hochladen möchtest.

Standardzugang ist öffentlich bekannt

Stelle die Anwendung erst nach dem Passwortwechsel über VPN oder Reverse-Proxy bereit. Leite Port 8083 niemals mit unveränderten Standarddaten im Router weiter.

5. Bibliothek und Import einstellen¶

Die Bibliothek liegt im Container unter /calibre-library. Bei einer neuen Installation erzeugt Calibre-Web Automated dort automatisch die benötigte Calibre-Struktur. Konfiguriere danach in den CWA-Einstellungen gewünschtes Zielformat und Importregeln.

Der Ordner ingest ist nur ein Eingang. Erfolgreich verarbeitete Dateien werden daraus entfernt und in die Bibliothek übernommen.

Ingest ist kein Ablage- oder Downloadordner

Bewahre dort keine Originale auf. Lade Dateien immer vollständig in einen anderen Ordner herunter und kopiere sie erst anschließend nach ingest, sonst drohen unvollständige oder doppelte Importe.

6. Erstes E-Book importieren¶

Kopiere eine vollständig heruntergeladene, legal erworbene Testdatei in den Eingangsordner. Ersetze <pfad-zur-testdatei.epub> durch den tatsächlichen Pfad auf dem Docker-Server:

cp '<pfad-zur-testdatei.epub>' ~/calibre-web-automated/ingest/

Beobachte den Import im Protokoll:

docker compose logs -f calibre-web-automated

Beende die laufende Protokollansicht mit Strg+C. Das beendet nur die Anzeige, nicht den Container. Falls das Buch nicht erscheint, starte in der Oberfläche Library Refresh.

7. Vollständiges Backup erstellen¶

Stoppe den Container kurz, damit Anwendungs- und Calibre-Datenbanken konsistent bleiben:

docker compose stop calibre-web-automated

Archiviere Konfiguration, Bibliothek, Compose-Datei und Benutzerwerte. Der temporäre Importordner wird bewusst nicht gesichert:

tar -czf calibre-web-automated-backup-$(date +%F-%H%M).tar.gz config library compose.yaml .env

Starte den Dienst danach wieder:

docker compose start calibre-web-automated

Kopiere das Archiv auf ein anderes Gerät. Zur Wiederherstellung stoppst du den Container, benennst die beschädigten Ordner um und entpackst das Archiv wieder im Projektordner.

8. Sicher aktualisieren und zurückbauen¶

Erstelle vor dem Update ein Backup und lade dann das aktuelle Image:

docker compose pull

Ersetze den Container mit unveränderten Ordnern:

docker compose up -d

Für einen Rückbau ohne Datenverlust entfernst du nur den Container und das Netzwerk:

docker compose down

Die lokalen Ordner bleiben erhalten. Lösche config oder library erst nach einem getesteten Backup.

9. Typische Fehler beheben¶

Weboberfläche nicht erreichbar: Prüfe Port 8083, Containerstatus und Protokolle.
Import bleibt liegen: Kontrolliere Dateirechte, warte auf vollständiges Kopieren und löse anschließend einen manuellen Library Refresh aus.
Bibliothek leer: Prüfe, ob ./library wirklich nach /calibre-library gemountet ist.
Dateien auf NAS-Freigabe: Setze NETWORK_SHARE_MODE nur nach Lesen der aktuellen Projekthinweise auf true; Netzwerkdateisysteme behandeln Sperren anders.
Zugriff aus dem Internet: Verwende HTTPS-Reverse-Proxy oder VPN und veröffentliche Port 8083 nicht zusätzlich direkt.

10. Quellen und Videos¶

Fertig¶

Calibre-Web Automated läuft jetzt mit getrennten Ordnern für Konfiguration, Import und Bibliothek. Die Funktionsprüfung ist erfolgreich, wenn die EPUB-Testdatei aus ingest verschwindet und anschließend mit Metadaten in der Webbibliothek erscheint.