Host je eigen boekenbibliotheek en open haar in Lectern

Kies de server die bij je bibliotheek past

Wil je alleen thuis boeken ophalen, begin dan met Calibre-Web. Storyteller is de extra installatie waard als synchroon lezen en luisteren je doel is. Lees de volledige vergelijking voor alle afwegingen.

Voordat je begint

• Een computer, NAS of thuisserver die aanstaat wanneer je wilt bladeren.
• Docker met Docker Compose en blijvende gegevensmappen.
• DRM-vrije EPUB-bestanden. Lectern verbergt items die alleen audio bevatten.
• Het lokale IP-adres van de server, bijvoorbeeld 192.168.1.50.

Begin op je eigen wifi. Bewijs eerst dat de catalogus lokaal werkt. Gebruik buitenshuis een VPN zoals Tailscale of een goed ingestelde HTTPS-reverse-proxy. Publiceer nooit een onversleutelde login op internet.

Route A: Calibre-Web

Onderstaand Compose-bestand volgt de onderhouden LinuxServer-image. Vervang beide /path/to/...-paden en pas PUID, PGID en de tijdzone aan. De boekenmap moet een geldige Calibre-bibliotheek met metadata.db bevatten.

services:
        calibre-web:
          image: lscr.io/linuxserver/calibre-web:latest
          container_name: calibre-web
          environment:
            - PUID=1000
            - PGID=1000
            - TZ=Etc/UTC
          volumes:
            - /path/to/calibre-web/config:/config
            - /path/to/calibre/library:/books
          ports:
            - 8083:8083
          restart: unless-stopped

1. Sla dit op als compose.yaml en voer docker compose up -d uit.
2. Open http://SERVER-IP:8083 en stel de bibliotheeklocatie in op /books.
3. Log in met admin en admin123 en wijzig dit standaardwachtwoord direct.
4. Voeg boeken toe via Calibre. Wil je een bewaakte importmap en automatische conversie, gebruik dan Calibre-Web Automated.
5. Test http://SERVER-IP:8083/opds in een browser. Een login of feedantwoord betekent dat het eindpunt bereikbaar is.

De actuele image en update-instructies staan in de officiële LinuxServer-repository. Die pagina is leidend als de Compose-template verandert.

Route B: Storyteller

Storyteller kan een DRM-vrij e-book met het bijbehorende audioboek uitlijnen en als standaard EPUB 3-meeleesboek exporteren. Maak een geheim met openssl rand -base64 32, zet alleen de waarde in STORYTELLER_SECRET_KEY.txt en gebruik dit bestand.

services:
        web:
          image: registry.gitlab.com/storyteller-platform/storyteller:latest
          volumes:
            - /path/to/storyteller/data:/data:rw
          environment:
            - STORYTELLER_SECRET_KEY_FILE=/run/secrets/secret_key
          ports:
            - "8001:8001"
          secrets:
            - secret_key
          restart: unless-stopped
      secrets:
        secret_key:
          file: ./STORYTELLER_SECRET_KEY.txt

1. Voer docker compose up -d uit en open http://SERVER-IP:8001.
2. Maak het beheerdersaccount en voeg een e-book, audioboek of beide als één boek toe.
3. Heb je beide bestanden, start dan het uitlijnen en geef de server tijd.
4. De OPDS-feed staat standaard aan, dus meestal heb je alleen je inloggegevens nodig. Is hij ooit uitgezet, zet hem dan terug aan bij Instellingen → OPDS: een uitgeschakelde feed antwoordt met een 404. Het eindpunt is https://JOUW-SERVER/opds.
5. Gebruik in Lectern je normale Storyteller-gebruikersnaam en wachtwoord.

Controleer bij updates de actuele Storyteller-hostinggids en OPDS-documentatie. Storyteller biedt audio en EPUB samen aan; Lectern toont de EPUB- en meeleesedities die het kan importeren.

Koppel de server aan Lectern

1. Open je bibliotheek. Tik op de plus en kies Gratis en zelfgehoste boeken.
2. Kies Storyteller of Calibre-Web. Lectern kent voor beide het gebruikelijke OPDS-pad.
3. Vul het serveradres in. Gebruik lokaal bijvoorbeeld http://192.168.1.50:8083, of je HTTPS-domein. Lectern vult /opds aan als dat nodig is.
4. Vul gebruikersnaam en wachtwoord in. Ze blijven versleuteld op dit Android-toestel.
5. Tik op Verbinden. Blader, zoek en download een EPUB. Het boek komt in je gewone Lectern-bibliotheek en blijft offline beschikbaar.

Gebruikt je reverse-proxy een subpad, voer dan de volledige feed-URL in, bijvoorbeeld https://boeken.example.com/calibre/opds. Kies voor andere servers Andere OPDS-feed en plak de complete URL.

Los veelvoorkomende problemen op

Lectern bereikt de server niet

Gebruik geen localhost: op je telefoon verwijst dat naar de telefoon zelf. Gebruik het LAN-adres van de server en controleer wifi en firewallpoort 8083 of 8001.

De catalogus vraagt opnieuw om inloggen

Test dezelfde gegevens eerst in de webinterface. Een installatie die alleen OAuth toestaat, heeft mogelijk een aparte lokale gebruiker voor OPDS nodig.

De catalogus is leeg

Controleer of de feed echt een EPUB aanbiedt. Voeg in Storyteller een EPUB toe of rond het meeleesboek af. Zorg in Calibre-Web dat de titel een EPUB-editie heeft.

HTTPS mislukt op Android

Gebruik een certificaat dat Android vertrouwt, inclusief de volledige certificaatketen. Een zelfondertekend certificaat wordt geweigerd tenzij je het bewust op het toestel vertrouwt.

Vragen over zelf gehoste OPDS