So installierst Du Calibre-Web Automated
20/03/2026
Das Wichtigste auf einen Blick
Mit Calibre-Web Automated kannst Du eine selbst gehostete E-Book-Bibliothek mit minimalem manuellem Aufwand betreiben. Es organisiert, konvertiert und verwaltet Bücher automatisch, während Metadaten konsistent und Geräte synchronisiert bleiben. Der Leitfaden bietet eine vollständige Anleitung zur Installation und Konfiguration von CWA auf einem Linux-Server mit Docker.
Die automatische und effiziente Installation von Calibre-Web kann die Verwaltung einer selbst gehosteten E-Book-Bibliothek grundlegend verändern. Die Einrichtung herkömmlicher Tools wie Calibre und Calibre-Web erfordert oft den Einsatz mehrerer Dienste, was zeitaufwendig und fehleranfällig sein kann.
Calibre-Web Automated (CWA) optimiert diesen Prozess durch die Kombination von Automatisierung, Docker-basierter Bereitstellung und einer wachsenden Anzahl von Funktionen, die die Verwaltung digitaler Bibliotheken vereinfachen. Es hat sich schnell zu einem Favoriten in der Self-Hosting-Community für alle entwickelt, die ein komplettes, automatisiertes E-Book-System betreiben möchten.
In dieser Anleitung führen wir Dich durch den gesamten Installationsprozess auf einem Linux-VPS oder -Server mit Docker Compose, von der Vorbereitung Deiner Umgebung und der Organisation von Ordnern bis zum ersten Zugriff auf die Weboberfläche.
Calibre-Web Automated verstehen
Calibre-Web Automated (CWA), entwickelt vom Entwickler crocodilestick, kombiniert das robuste Backend von Calibre mit der schlanken Weboberfläche von Calibre-Web in einem einzigen Docker-Container. Es macht separate Dienste überflüssig und fügt gleichzeitig Automatisierungsfunktionen hinzu, die die Bibliotheksverwaltung vereinfachen und den manuellen Aufwand reduzieren. Anfang 2026 hatte es über 5.000 GitHub-Sterne und Beiträge von 99 Entwicklern und ist damit eines der am aktivsten gepflegten selbst gehosteten E-Book-Tools.
Die wichtigsten Vorteile von Calibre-Web Automated
- Automatische Erfassung: Leg einfach eBooks in einem bestimmten Ordner ab; CWA erkennt, verarbeitet und importiert sie automatisch.
- Formatkonvertierung: Unterstütze 28 Eingabeformate und konvertiere sie in EPUB, MOBI, AZW3, KEPUB oder PDF.
- Aktualisierung von Metadaten und Covern: Änderungen, die in der Web-Benutzeroberfläche vorgenommen werden, werden direkt auf die eBook-Dateien angewendet, sodass Deine Bibliothek auf allen Geräten konsistent bleibt.
- EPUB-Reparatur: Behebe häufige EPUB-Probleme wie fehlerhafte Kodierung, ungültige Links und fehlerhafte Sprach-Tags.
- Duplikaterkennung: Identifiziere Duplikate mithilfe von SQL und Fuzzy-Matching, mit Optionen zum Zusammenführen oder zur Stapelverarbeitung.
- KOReader-Synchronisierung: Verfolge den Lesefortschritt für KOReader-Benutzer automatisch.
- Dynamische Regale: Organisiere Bücher automatisch nach von dir definierten Regeln und Filtern.
- Automatisches Senden an eReader: Sende neu hinzugefügte Bücher per E-Mail an Dein Gerät, mit konfigurierbaren Formaten und Verzögerungen.
- Bibliotheksanalyse: Interaktive Statistiken zu Benutzeraktivitäten, Bibliotheksgröße, API-Nutzung und Trends, exportierbar nach CSV.
- Update-Benachrichtigungen: Benachrichtige Administratoren in der Web-Benutzeroberfläche, wenn eine neue Version verfügbar ist.
Systemanforderungen für die Installation von Calibre-Web Automated
Bevor Du Calibre-Web Automated (CWA) installierst, solltest Du sicherstellen, dass Dein Server oder VPS die folgenden Anforderungen erfüllt:
- Betriebssystem: Nur Linux-basiert. Empfohlene Distributionen: Ubuntu 22.04 LTS, Ubuntu 24.04 LTS, Debian 11 oder Debian 12.
- Docker Engine: Version 20.10 oder höher. Wird benötigt, um CWA in einer containerisierten Umgebung auszuführen.
- Docker Compose: Version 2.x oder höher. Moderne Docker-Installationen haben das als eingebautes Plugin.
- CPU: Mindestens 1 vCPU; 2 oder mehr vCPUs sind besser, vor allem wenn Du die automatische Formatkonvertierung nutzen willst.
- RAM: Mindestens 1 GB; 2 GB sind für eine reibungslose Leistung empfehlenswert. 4 GB sind ideal für große Bibliotheken oder umfangreiche Konvertierungen.
- Speicherplatz: Mindestens 10 GB freier Festplattenspeicher. Weise mindestens 20 GB zu, damit Deine E-Book-Bibliothek problemlos wachsen kann.
- Netzwerk: Port 8083 muss offen und zugänglich sein (Standard-Port der CWA-Webschnittstelle).
- Benutzerrechte: Sudo-Rechte sind erforderlich, um Docker zu installieren und Verzeichnisse zu erstellen.
- Terminalzugriff: Grundlegende Kenntnisse der Linux-Befehlszeile sind hilfreich. Alle Befehle in dieser Anleitung sind klar und anfängerfreundlich geschrieben.
Die Ordnerstruktur verstehen, bevor Du beginnst
Bevor Du einen einzigen Befehl ausführst, ist es wichtig, die Ordnerstruktur zu verstehen, die Calibre-Web Automated verwendet. CWA stützt sich auf drei Hauptverzeichnisbindungen, um korrekt zu funktionieren, und wenn Du weißt, was jede einzelne davon tut, kannst Du Verwirrung bei der Einrichtung der Docker Compose-Datei vermeiden.
Hier ist eine Übersicht über die einzelnen Ordner:
/config
Dies ist der interne Konfigurationsordner von CWA. Er speichert die Anwendungsdatenbank (app.db), Protokolle, verarbeitete Buch-Backups und andere Dateien, die CWA am Laufen halten. Für neue Benutzer kann dies ein beliebiger leerer Ordner auf Deinem Server sein.
/cwa-book-ingest
Dies ist der Ingest-Ordner. In diesem Ordner legst Du neue E-Book-Dateien ab, um sie Deiner Bibliothek hinzuzufügen. Das ist kein permanenter Speicherordner. Alle Dateien, die Du hier ablegen, werden automatisch analysiert, bei Bedarf konvertiert und in Deine Bibliothek importiert. Danach wird die Originaldatei aus diesem Ordner gelöscht. Verwende diesen Ordner niemals als permanenten Speicherort für Deine Bücher.
/calibre-library
Hier befindet sich Deine eigentliche Calibre-Bibliothek. Sie enthält die Datei metadata.db und alle Deine E-Book-Dateien, sortiert nach Autor und Titel. Neue Benutzer ohne vorhandene Bibliothek können diesen Ordner auf einen beliebigen leeren Ordner verweisen, und CWA erstellt automatisch eine neue Calibre-Bibliothek für Dich.
/config/.config/calibre/plugins (Optional)
Dieser Ordner wird nur benötigt, wenn du Calibre-Plugins verwendest. Wenn Du keine Calibre-Plugins verwendest, kannst Du diese Bindung getrost überspringen.
Eine wichtige Regel, die Du beachten solltest: Alle drei Hauptordner müssen komplett separate Verzeichnisse sein. Verschachtle sie nicht ineinander, da das zu Fehlern beim Betrieb führen kann.
Calibre-Web automatisch installieren
Nachdem Du Deine Umgebung vorbereitet und die Ordnerstruktur verstanden hast, kannst Du mit der Installation loslegen.
Schritt 1: Aktualisiere Dein System
Nachdem Du eine Verbindung zu Deinem VPS hergestellt hast, aktualisiere die Paketliste Deines Systems und aktualisiere alle veralteten Pakete, um eine saubere, stabile Umgebung zu gewährleisten.
Führe den folgenden Befehl aus:
sudo apt update && sudo apt upgrade -y
Dieser Befehl aktualisiert die Paketliste (apt update) und installiert verfügbare Updates automatisch (apt upgrade -y). Warte, bis der Vorgang abgeschlossen ist, bevor Du fortfährst.
Schritt 2: Installiere Docker
Docker ist die Grundlage für die Ausführung von CWA. Wir installieren Docker Engine mit der offiziellen Methode, bei der das Repository von Docker und die erforderlichen Abhängigkeiten hinzugefügt werden.
Beginne mit der Installation der Abhängigkeiten:
sudo apt install -y ca-certificates curl
Füge den offiziellen GPG-Schlüssel von Docker hinzu:
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
Füge das Repository zu Deinem System hinzu:
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc]
https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo „$VERSION_CODENAME“) stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Aktualisiere die Paketliste nochmal:
sudo apt update
Installiere die Docker Engine und das Compose-Plugin:
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Starte Docker und aktiviere es beim Booten:
sudo systemctl start docker
sudo systemctl enable docker
Überprüfe die Installation:
docker --version
Du solltest eine Ausgabe ähnlich der folgenden sehen:
Docker Version 27.x.x, Build xxxxxxx
Schritt 3: Überprüfe Docker Compose
Überprüfe, ob Docker Compose verfügbar ist:
docker compose version
Erwartete Ausgabe:
Docker Compose version v2.x.x
Wenn sowohl Docker als auch Docker Compose bestätigt sind, kannst Du fortfahren.
Schritt 4: Erstelle die Verzeichnisstruktur
Erstelle den Hauptprojektordner:
mkdir -p ~/docker/calibre-web-automated
Navigiere dorthin:
cd ~/docker/calibre-web-automated
Erstelle die drei erforderlichen Unterverzeichnisse:
mkdir -p config cwa-book-ingest calibre-library
Überprüfe die Ordner:
ls -la
Stell die richtigen Besitzrechte ein, um Berechtigungsfehler zu vermeiden:
chown -R 1000:1000 config cwa-book-ingest calibre-library
Schritt 5: Erstelle die Docker-Compose-Datei
Jetzt erstellen wir die Datei „docker-compose.yml“, die festlegt, wie der CWA-Container konfiguriert und ausgeführt wird. Das ist das Herzstück der Installation.
Vergewissere Dich, dass Du Dich im Projektverzeichnis befindest:
cd ~/docker/calibre-web-automated
Mach die Docker-Compose-Datei mit nano:
nano docker-compose.yml
Füge die folgende Konfiguration in die Datei ein:
---
services:
calibre-web-automated:
image: crocodilestick/calibre-web-automated:latest
container_name: calibre-web-automated
environment:
- PUID=1000
- PGID=1000
- TZ=UTC
- NETWORK_SHARE_MODE=false
- CWA_PORT_OVERRIDE=8083
volumes:
- ./config:/config
- ./cwa-book-ingest:/cwa-book-ingest
- ./calibre-library:/calibre-library
ports:
- 8083:8083
restart: unless-stopped
Hier ist, was die einzelnen Teile dieser Konfiguration bedeuten:
- Image: Sag Docker, dass es das neueste offizielle Calibre-Web Automated-Image von Docker Hub holen soll.
- Container_name: Gib dem Container einen benutzerfreundlichen Namen, damit er in Befehlen leicht zu referenzieren ist.
- PUID und PGID: Die Benutzer- und Gruppen-IDs, unter denen der Container laufen wird. Der Wert 1000 ist der Standardwert für den ersten Nicht-Root-Benutzer auf den meisten Linux-Systemen.
- TZ: Deine Zeitzone. Ersetze UTC durch Deine lokale Zeitzone (z. B. America/New_York, Europe/London oder Asia/Manila).
- NETWORK_SHARE_MODE: Setz den Wert für lokale Festplattenkonfigurationen auf „false”. Setz den Wert nur auf „true”, wenn Deine Bibliothek auf einer Netzwerkfreigabe (NFS oder SMB) gespeichert ist.
- CWA_PORT_OVERRIDE: Der Port, auf dem die Webschnittstelle von CWA ausgeführt wird. Der Standardwert ist 8083.
- Volumes: Ordne die auf Deinem Server erstellten Ordner den Pfaden zu, die CWA innerhalb des Containers erwartet.
- Ports: Stell Port 8083 bereit, sodass Du über einen Browser auf die Webschnittstelle zugreifen kannst.
- restart: unless-stopped: Stell sicher, dass der Container bei einem Neustart des Servers automatisch neu gestartet wird, sofern er nicht manuell angehalten wurde.
Nachdem Du die Konfiguration eingefügt und alle erforderlichen Anpassungen vorgenommen hast (insbesondere den TZ-Wert), speichere die Datei und beende sie, indem Du Strg + X, dann Y und anschließend die Eingabetaste drückst.
Schritt 6: Container ausführen
Container starten:
docker compose up -d
Das Flag -d führt den Container im Hintergrund aus. Docker ruft beim ersten Start das CWA-Image ab und erstellt automatisch eine neue Bibliothek, falls noch keine vorhanden ist, einschließlich metadata.db.
Schritt 7: Überprüfe, ob der Container läuft
Überprüfe den Containerstatus:
docker ps
Schau Dir bei Bedarf die Startprotokolle an:
docker logs calibre-web-automated
Erfolgreiche Protokolle zeigen an, dass die CWA-Dienste initialisiert wurden und der Webserver auf Port 8083 läuft.
Erste Einrichtung (nach der Installation)
Zugriff auf die Web-Benutzeroberfläche
Öffne einen Webbrowser und geh zu:
http://your-server-ip:8083
Ersetze your-server-ip durch die tatsächliche IP-Adresse Deines Servers. Beispiel:
http://213.180.77.169:8083
Die automatische Anmeldeseite von Calibre-Web sollte erscheinen.
Anmelden mit Standard-Anmeldedaten
Gib auf der Anmeldeseite die folgenden Standard-Anmeldedaten ein:
Benutzername: admin
Passwort: admin123
Klicke auf Anmelden, um auf das Dashboard zuzugreifen.
Ändern des Admin-Passworts
Nach der Anmeldung solltest Du als Erstes das Standard-Passwort ändern. Wenn Du es nicht änderst, ist das ein echtes Sicherheitsrisiko, vor allem, wenn Dein Server öffentlich zugänglich ist.
So änderst Du Dein Passwort:
- Klick auf das Benutzersymbol oben rechts auf der Seite.
- Wähl im Dropdown-Menü die Option Profil aus.
- Scroll zum Passwortfeld.
- Gib Dein neues Passwort ein und bestätige es.
- Klick auf Speichern, um die Änderungen zu übernehmen.
Wähle ein sicheres Passwort, das Du Dir merken kannst, und kombiniere Buchstaben, Zahlen und Sonderzeichen, um die Sicherheit zu erhöhen.
Uploads und Bibliothekseinstellungen verwalten
Uploads aktivieren
Sobald CWA läuft, kannst Du über die Weboberfläche Bücher direkt aus Deinem Browser hochladen. Wenn Du Uploads aktivierst, erscheint eine Upload-Schaltfläche auf dem Dashboard, sodass Du Bücher hinzufügen kannst, ohne mit dem Dateisystem des Servers interagieren zu müssen. Diese Funktion ist ideal, um schnell neue Inhalte hinzuzufügen und gleichzeitig den automatisierten Workflow von CWA beizubehalten.
Konfigurieren der automatischen Verarbeitung
CWA bietet Einstellungen, mit denen Du die Verarbeitung von Büchern steuern kannst. Du kannst ein Zielformat für die automatische Konvertierung festlegen, wobei EPUB für eine breite Kompatibilität empfohlen wird. Andere unterstützte Formate sind MOBI, AZW3, KEPUB und PDF. Die automatische Konvertierung stellt sicher, dass alle Bücher in einem Nicht-Zielformat nahtlos konvertiert werden, während unerwünschte Formate vollständig übersprungen werden können. Diese Einstellungen helfen dabei, eine konsistente Bibliothek ohne manuelle Eingriffe zu erhalten.
Verwendung des Importordners
Der Importordner ist der Hauptspeicherort für neue Bücher. Wenn eine Datei hinzugefügt wird, erkennt CWA diese, analysiert ihr Format, behebt Probleme mit der EPUB-Kompatibilität, ruft Metadaten ab und importiert das Buch in Deine Calibre-Bibliothek. Nach der Verarbeitung wird die Originaldatei aus dem Ordner entfernt. Diese Automatisierung sorgt dafür, dass Deine Bibliothek organisiert und auf dem neuesten Stand bleibt.
Wichtige Vorsichtsmaßnahmen
Um Probleme zu vermeiden, sollten Dateien niemals direkt in den Importordner heruntergeladen werden, da dies zu Duplikaten oder einer Beschädigung der Datenbank führen kann. Die Dateien müssen derselben Benutzer-ID gehören, die in PUID (Standard 1000) festgelegt ist. Die Eigentumsrechte können mit folgendem Befehl korrigiert werden:
chown 1000:1000 ~/docker/calibre-web-automated/cwa-book-ingest/your-book.epub
Wenn ein Buch nicht automatisch verarbeitet wird, kann die Schaltfläche „Library Refresh“ in der Web-Benutzeroberfläche die Erfassung manuell auslösen.
Unterstützte Formate
CWA unterstützt eine Vielzahl von Eingabeformaten, darunter .epub, .mobi, .azw3, .pdf, .fb2, .docx und .cbz. Wenn Uploads aktiviert, Zielformate konfiguriert und der Erfassungsordner überwacht sind, werden neue Bücher schnell, zuverlässig und automatisch hinzugefügt.
Fazit
Durch die Einrichtung von Calibre-Web Automated wird eine selbst gehostete E-Book-Bibliothek von einem manuellen, zeitaufwendigen Prozess in ein reibungsloses, automatisiertes System verwandelt. Durch die Kombination von Docker-basierter Bereitstellung mit Funktionen wie automatischer Erfassung, Formatkonvertierung und Bibliotheksanalyse macht CWA die Verwaltung digitaler Bücher einfach und zuverlässig.
Egal, ob Du eine persönliche Sammlung pflegst oder eine umfangreiche Bibliothek teilst, Calibre-Web Automated bietet eine solide, aktiv gepflegte Lösung, die mit Deinen Anforderungen mitwächst.
