selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
Calibre Web logo

Self-host Calibre Web

0.6.27

Web app for ebook libraries stored in a Calibre database

ReleaseOpen SourceGPL-3.0
pip install calibreweb
Updated3 months ago
LanguageFluent
Setup difficultyEasy
MobileResponsive
ThemeDark mode
Stars
18 559
Port
8083 (HTTP port the Calibre-Web web UI and OPDS catalog (/opds) are served on; changeable in the admin Server Port setting.)
Requires
ImageMagick
Docker
janeczku/calibre-web
Main library screen with the book cover gridLogin page showing the magic-link remote login entry

What is Calibre Web?

Calibre-Web is a Python web application that puts a browser interface on top of an existing Calibre library (metadata.db), so a collection can be browsed, read, downloaded and managed online. It offers in-browser reading of several formats, uploads in many formats including audiobooks, metadata editing and metadata fetching from online sources, and format conversion through the Calibre binaries. E-readers reach the collection through an OPDS catalog, with one-click sending to a device, Kobo device sync, and a "magic link" login for hardware where typing is awkward. Several people can share one instance: rights are set per user, public registration and anonymous browsing are optional, and books can be hidden from particular users via Calibre custom columns or tags. Login can also come from LDAP, Google or GitHub OAuth, or from an authenticating reverse proxy. Nearly everything is configured in the admin panel, from the library path to themes, logging and external binary locations. Self-hosting is simple: a pip install inside a virtual environment (Python 3.7 or newer, plus ImageMagick for cover extraction) or the published LinuxServer container listening on port 8083. The project is GPL v3 licensed, actively released, and grew out of an older Calibre web front-end.

Calibre Web alternatives

Should you self-host Calibre Web?

Calibre Web scores 77/100 on selfhost.directory (how scoring works) and ranks #2 of 9 in E-book Management. It has 18 559 GitHub stars, +202 in the last 30 days.

It shipped 2 stable releases in the past year. The latest, 0.6.27, came out on 8 August 2026. New versions land roughly every 6 months.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Fluent.

Its closest alternative on selfhost.directory is koodo-reader (78/100, 28 830 stars). It scores higher overall, so compare the two before you pick. See Calibre Web vs koodo-reader side by side.

Features

  • Book Upload
  • Content visibility restrictions
  • eBook format conversionRequires the optional Calibre binaries / docker mod layer.
  • In-browser eBook reader
  • Kobo device sync
  • Metadata Editing
  • Metadata fetching from online sources
  • Multilingual interface
  • OPDS Catalog
  • Public registration and anonymous browsing
  • Search and filtering
  • Self-update
  • Send books to e-readers
  • User management with per-user permissions

Calibre Web README

How to install Calibre Web

Install Calibre Web with Docker

Environment variables
PUID, PGID, TZ, DOCKER_MODS, OAUTHLIB_RELAX_TOKEN_SCOPE

docker run -d
--name=calibre-web
-e PUID=1000
-e PGID=1000
-e TZ=Etc/UTC
-e DOCKER_MODS=linuxserver/mods:universal-calibre #optional
-e OAUTHLIB_RELAX_TOKEN_SCOPE=1 #optional
-p 8083:8083
-v /path/to/calibre-web/data:/config
-v /path/to/calibre/library:/books
--restart unless-stopped
lscr.io/linuxserver/calibre-web:latest

Plain docker run alternative to the compose stack; images published for x86-64 and arm64 with latest and nightly tags.

How to configure Calibre Web

  • DOCKER_MODSIn the LinuxServer container, adds the universal-calibre layer with the Calibre ebook-convert binary (x64 only); omit for a lightweight image.

    values: linuxserver/mods:universal-calibre

  • OAUTHLIB_RELAX_TOKEN_SCOPESet to 1 in the LinuxServer container to allow Google OAuth login to work.

    values: 1

  • PUID1000User ID the container runs as, to match volume ownership on the host.
  • PGID1000Group ID the container runs as, to match volume ownership on the host.
  • TZEtc/UTCTimezone used inside the container.

Calibre Web releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Which picture formats are supported in the comic reader?

The comic reader handles jpg, jpeg, png, gif (non-animated) and svg images.

How to access a opds link for a given shelf

A shelf can be opened directly as an OPDS library at /opds/shelf/{shelf_id}, without a trailing slash.

How to handle Multiple Calibre Libraries?

The recommended approach is running one Calibre-Web instance per library, each with its own app.db and port, started with the -p command-line parameter.

What to do if cover pictures are not extracted from PDF files?

ImageMagick blocks PDF processing by default; change the PDF policy line in its policy.xml from rights="none" to rights="read" and restart Calibre-Web.

Can Calibre-Web execute malicious code in an epub?

Merely organizing epubs touches nothing; the built-in epub reader unpacks the file and serves its HTML/JavaScript to the browser, so hostile code inside an epub could be executed there.

What is the maximum file-size which can be uploaded through Calibre-Web?

The default embedded server caps uploads at 200 MB; the optional Gevent server has no hardcoded limit.

Why don't you support Calibre's virtual Libs?

Virtual libraries are Calibre search-language queries, and supporting them would mean reimplementing Calibre's search, which is outside the project's scope.

Which OPDS-Readers work with Calibre-Web?

The FAQ lists a number of tested OPDS readers on iOS, Android, Kobo, Kindle, desktop and Linux; some only show covers or allow downloads when anonymous browsing is enabled.

How to Backup Calibre-Web Settings?

All settings live in app.db in the project root; with Google Drive storage also back up gdrive.db, settings.yaml and gdrive_credentials.

What do I do if I lose my "Admin" password?

Another admin can generate a new password, or you can stop Calibre-Web and restart it with the command-line option -s [username]:[newpassword].

What to do with problems during installation with error message "Import-Error"?

A required Python module is missing; install it with `pip[3] --target vendor install [module-name]` (pip3 for Python 3.x).

More in E-book Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…