calibre-web OPDS auf iPhone und iPad: die genaue URL und der Login

Kurze Antwort: Der OPDS-Feed von calibre-web liegt unter http://<dein-server>:8083/opds. Er verlangt denselben Benutzernamen und dasselbe Passwort, die du auch für die calibre-web-Weboberfläche verwendest, über HTTP Basic-Authentifizierung, und deine Browser-Sitzung wird nicht übernommen, du gibst die Zugangsdaten also erneut in der Reader-App ein. Calibre-Web-Automated verwendet genau dieselbe Adresse und denselben Login. Füge diese URL als eigenen OPDS-Katalog in einer Reader-App auf deinem iPhone oder iPad hinzu, und deine Calibre-Bibliothek ist da.

Alles Folgende wurde am 24.08.2026 gegen calibre-web 0.6.27 und Calibre-Web-Automated v4.0.6 geprüft, beide aus ihren offiziellen Images gegen eine echte Calibre-Bibliothek betrieben, statt aus der Dokumentation abgeschrieben.

Die Adresse und die drei Dinge, die schiefgehen

1. Die Web-Sitzung authentifiziert den Feed nicht

Das ist der Punkt, der Leute erwischt, die calibre-web in einem Browser-Tab offen haben und annehmen, die Reader-App werde auf dieselbe Weise hereingelassen. Wird sie nicht. Der Feed nutzt Basic-Authentifizierung, vollständig getrennt vom Cookie deines Browsers, und antwortet mit 401 samt WWW-Authenticate-Header, bis du Benutzernamen und Passwort angibst.

Das ist gute Nachricht für die Einrichtung: Jede OPDS-Reader-App, die Benutzernamen und Passwort unterstützt, kann sich verbinden. In justRead fügst du den Server einmal mit URL, Benutzername und Passwort hinzu, und er wird gespeichert.

2. Eine Weiterleitung statt eines Feeds bedeutet, der Server ist nicht konfiguriert

Bevor calibre-web auf eine Calibre-Datenbank zeigt, gibt jeder Pfad darauf, /opds eingeschlossen, ein 302 auf /admin/dbconfig zurück. Wenn deine Reader-App etwas Merkwürdiges meldet, statt nach einem Passwort zu fragen, öffne http://<dein-server>:8083/ in einem Browser. Landest du auf einer Datenbank-Konfigurationsseite, war die URL nie das Problem: Ein Administrator muss zuerst den Pfad zur Calibre-Bibliothek setzen.

Calibre-Web-Automated hat dieses Problem nicht. Es kommt mit einer bereits konfigurierten Bibliothek und liefert OPDS beim ersten Start, was wichtig zu wissen ist, wenn du zwischen beiden wählst und das Telefon noch heute funktionieren soll.

3. Port 8083, nicht 8080

8080 ist der Calibre Content Server, ein anderes Programm als calibre-web, das wir in der Calibre-Content-Server-Anleitung behandeln. Die beiden werden ständig verwechselt, und ihre Ports zu vertauschen erzeugt einen Verbindungsfehler, der wie ein Netzwerkproblem aussieht.

Sie unterscheiden sich auch bei der Authentifizierung auf eine Weise, die hier zählt: Der Calibre Content Server hat standardmäßig gar keine Authentifizierung, während calibre-web sie immer verlangt. Hat sich deine Reader-App mit einem Calibre-ähnlichen Server verbunden, ohne nach einem Passwort zu fragen, war das der Content Server.

Was du bekommst, sobald es verbunden ist

Die OPDS-Wurzel von calibre-web liefert fünfzehn Bereiche. Alle fünfzehn waren in beiden getesteten Versionen vorhanden:

Alphabetisch nach Bücher, Beliebte Bücher, Bestbewertete Bücher, Kürzlich hinzugefügte Bücher, Zufällige Bücher, Gelesene Bücher, Ungelesene Bücher, Autoren, Verlage, Kategorien, Serien, Sprachen, Bewertungen, Dateiformate, Regale.

Das ist dieselbe Struktur wie die Weboberfläche, und genau das ist der Punkt: Die Metadaten, die du in Calibre gepflegt hast, die Serien, die Bewertungen, die eigenen Regale, kommen mit, statt in eine lange Liste zu verflachen.

Die Suche steht zweifach zur Verfügung, als vorlagenbasierte /opds/search/{searchTerms} und als OpenSearch-Deskriptor unter /opds/osd, sodass eine Reader-App mit serverseitiger Suche den Server abfragen kann, statt alles herunterzuladen und lokal zu suchen. Dieser Unterschied zählt bereits bei ein paar Tausend Büchern.

calibre-web vs. Calibre-Web-Automated: was sich wirklich unterscheidet

Calibre-Web-Automated ist ein aktiv weiterentwickelter Fork, der automatische Aufnahme, Konvertierung und Metadatenverwaltung auf calibre-web aufsetzt. Die naheliegende Frage für ein Telefon ist, ob sich sein OPDS-Feed unterscheidet.

Wir haben beide nebeneinander laufen lassen und die Feeds verglichen. Die Antwort: gleiche URL, gleiche Authentifizierung, und genau ein zusätzlicher Bereich.

Calibre-Web Automated      (feed title)
Calibre-Web

Magic Shelves              (present in CWA only)

Alles andere ist identisch: /opds, HTTP Basic, und dieselben fünfzehn Bereiche in derselben Reihenfolge. Was für das OPDS von calibre-web gilt, gilt auch für das von CWA.

Der einzige praktische Unterschied liegt gar nicht im Feed. CWA kommt mit einer konfigurierten Bibliothek und antwortet beim ersten Start; das schlichte calibre-web leitet alles auf /admin/dbconfig um, bis jemand den Datenbankpfad setzt.

Verbindung herstellen auf iPhone oder iPad

1. Finde die Adresse deines Servers im Netzwerk. Eine lokale IP wie 192.168.1.20, oder ein Hostname, falls du einen hast. Reserviere sie in den DHCP-Einstellungen deines Routers, sonst ändert sich die Adresse und der Katalog funktioniert ohne erkennbaren Grund nicht mehr.
2. Bestätige den Feed zuerst in einem Browser. Oeffne http://<dein-server>:8083/opds. Du solltest nach Benutzername und Passwort gefragt werden und dann eine Wand aus XML sehen. Wirst du auf eine Einrichtungsseite umgeleitet, gehe zurück zu Punkt 2 oben.
3. Füge ihn in deiner Reader-App als eigenen OPDS-Katalog hinzu: die URL, deinen calibre-web-Benutzernamen, dein calibre-web-Passwort.
4. Durchstöbern und herunterladen. OPDS gibt Dateien heraus, statt Seiten zu streamen, ein Buch wird also auf das Gerät heruntergeladen und dort gelesen. Das bedeutet auch, es funktioniert weiter, wenn du nicht am Server bist, und deine Leseposition bleibt auf dem Telefon, statt zu calibre-web zurückzusynchronisieren.

Für die allgemeine Version dieser Schritte, gültig für jeden Server, siehe OPDS auf iPhone und iPad einrichten.

Zugriff von außerhalb deines Zuhauses

Innerhalb deines eigenen Netzwerks ist reines HTTP in Ordnung und die einfachste Lösung, die funktioniert.

Von außerhalb solltest du Port 8083 nicht einfach weiterleiten. Zwei Ansätze sind die Mühe wert:

• Ein Reverse-Proxy mit einem echten Zertifikat. Caddy oder nginx vor calibre-web, mit einem Zertifikat von Let's Encrypt, gibt dir HTTPS, dem iOS vertraut, ganz ohne Gerätekonfiguration.
• Ein VPN oder ein Mesh-Netzwerk zurück in dein eigenes LAN, wonach die lokale Adresse von überall unverändert funktioniert.

Was beiläufig nicht funktioniert, ist ein selbstsigniertes Zertifikat. iOS lehnt eines ab, es sei denn, das Zertifikat wird auf dem Gerät installiert und unter Einstellungen, Allgemein, Info, Zertifikatsvertrauenseinstellungen ausdrücklich als vertrauenswürdig markiert. Bis dahin schlägt die Verbindung einfach fehl, und der Fehler sieht genauso aus wie ein ausgefallener Server statt wie ein Zertifikatsproblem.

Häufige Fehler, in der Reihenfolge, in der sie meist auftreten

"Es fragt nach einem Passwort und lehnt das richtige ab." calibre-web hat eigene Benutzerkonten, getrennt von jedem Betriebssystem-Login. Verwende das Konto, mit dem du dich in der Weboberfläche von calibre-web anmeldest. Der Standard bei einer frischen Installation ist admin mit dem Passwort admin123, das du ändern solltest, bevor irgendetwas von außen erreichbar ist.

"Ich bekomme eine Weiterleitung, keinen Feed." Der Datenbankpfad ist nicht konfiguriert. Siehe oben.

"Es hat gestern funktioniert und heute nicht." Fast immer hat sich die IP-Adresse des Servers geändert. Reserviere sie in deinem Router.

"Der Katalog ist leer." calibre-web zeigt auf eine Calibre-Bibliothek ohne Bücher, oder auf ein Verzeichnis, das keine Calibre-Bibliothek ist. Die Weboberfläche wirkt dann genauso leer; sieh dort zuerst nach, denn der Feed zeigt immer nur das, was calibre-web selbst sehen kann.

"Manche Bücher laden nicht herunter." calibre-web liefert die Formate, die in deiner Calibre-Bibliothek vorhanden sind. Existiert ein Buch nur als AZW3 oder MOBI, konvertiere es in Calibre auf dem Desktop zu EPUB, und das konvertierte Format erscheint im Feed.

Wo das im Vergleich zu den anderen Optionen steht

Wenn deine Bücher in Calibre liegen und du sie auf einem iPhone willst, gibt es drei Wege, und sie unterscheiden sich wirklich:

• calibre-web, diese Seite: ein Web-Frontend, das ohne geöffnete Calibre-Desktop-App läuft, mit Benutzerkonten und einem OPDS-Feed unter :8083/opds.
• Der Calibre Content Server, unter :8080/opds, der in Calibre selbst eingebaut ist und die Desktop-App oder calibre-server laufend braucht. Er hat keine Authentifizierung, bis du sie aktivierst. Siehe die Content-Server-Anleitung.
• Ein Cloud-Ordner oder direktes Kopieren von Dateien, ganz ohne Server. Siehe Calibre mit iPhone und iPad synchronisieren.

justRead verbindet sich mit allen dreien, sowie mit Komga, Kavita, COPS und jedem anderen OPDS-Server, mit Filterung und Blätterung pro Server, damit eine große Bibliothek auf einem Telefon nutzbar bleibt. Die Seite OPDS-Reader führt die geprüfte URL und Authentifizierungsmethode für jeden getesteten Server auf, und die Liste der kostenlosen OPDS-Kataloge behandelt öffentliche Kataloge statt deiner eigenen Bibliothek.

justRead im App Store herunterladen und auf deinen calibre-web-Server richten.