Calibre-Web
Clean web UI for browsing, reading, and downloading your self-hosted Calibre ebook library.
Why consider Calibre-Web?
Calibre-Web is an open-source web app providing a clean reading interface for Calibre ebook libraries. It supports OPDS, Kindle sync, user management, and ebook format conversion.
Learn Calibre-Web by building
Practical setup notes, real use cases, and copy-ready examples in one focused guide.
In this guide10 sections
What is Calibre-Web?
Calibre-Web is an open-source web interface for managing and reading ebook libraries stored in the Calibre database format. Developed with Python (Flask), it operates as a clean, responsive browser-based alternative to the Calibre desktop application, allowing you to access, browse, and download your ebook collection from any device.
Calibre-Web layers a modern, mobile-friendly web UI on top of your existing Calibre metadata database, exposing full-text library search, genre and author browsing, user account management, OPDS catalog support for e-reader applications, Kindle email delivery, and on-the-fly ebook format conversion.
Who Is It For?
- Ebook Collectors: Browsing and downloading ebooks on mobile phones and tablets from a home server.
- Families: Sharing a centralized household ebook library with multiple user accounts.
- e-Reader Enthusiasts: Sending ebooks directly to Kindle Paperwhite or Kobo devices via the built-in email delivery.
Key Features
- Clean responsive web UI for browsing by author, genre, series, and custom shelves.
- OPDS catalog server: Compatible with Moon+ Reader, KyBook, FBReader, and other OPDS-capable e-reader apps.
- Kindle email delivery: Push ebooks directly to Kindle devices via Amazon's Send-to-Kindle email service.
- On-the-fly ebook format conversion: Convert between EPUB, PDF, MOBI, AZW3, and CBZ formats.
- Multi-user library access with individual reading progress, custom shelves, and download history.
Deploying Calibre-Web with Docker Compose
version: '3.5'services: calibre-web: image: lscr.io/linuxserver/calibre-web:latest container_name: calibre_web restart: unless-stopped environment: - PUID=1000 - PGID=1000 - TZ=UTC - DOCKER_MODS=linuxserver/mods:universal-calibre # Enables format conversion volumes: - ./config:/config - ./books:/books # Path to your Calibre library directory ports: - "8083:8083"Start the container:
docker compose up -dOpen http://localhost:8083 in your browser. On the initial setup screen, point the library path to /books/metadata.db.
Practical Use Cases
1. Mobile Ebook Library Access
A reader opens Calibre-Web on an Android tablet, searches their 2,000-ebook library by author, and downloads directly to a local reading app.
2. Kindle Direct Push Delivery
A user downloads a newly added EPUB, clicks "Send to Kindle", and the ebook appears wirelessly on their Paperwhite within minutes.
3. OPDS Catalog for Moon+ Reader
A reader configures Moon+ Reader's OPDS source to point to their Calibre-Web server, browsing and downloading ebooks without leaving the mobile app.
Troubleshooting and Limitations
- Calibre Metadata.db Required: Calibre-Web requires a valid Calibre
metadata.dbdatabase file in the books directory; create one by opening Calibre desktop once and pointing it to your ebook folder. - Format Conversion Prerequisites: Enable the LinuxServer universal-calibre Docker mod to install the Calibre conversion engine inside the container for MOBI/EPUB conversions.
Official Resources
- GitHub Repository: https://github.com/janeczku/calibre-web
- Documentation: https://github.com/janeczku/calibre-web/wiki
Related tools
More options with a similar category or technology profile.
McFly
Fly through your shell history with an intelligent neural network search engine.
cheat
Interactive command-line cheatsheets for system administrators and software engineers.
Pipenv
Python development workflow for humans uniting Pipfile, pip, and virtualenv.
Rye
Comprehensive Python package and workspace management tool written in Rust.