Calibre-Web — Self-Hosted eBook Library & Reader
Calibre-Web provides a polished web interface for browsing, reading, and managing your Calibre eBook library from any device with a browser.
Ready-to-run agent install
This asset can be installed after the agent chooses its runtime, checks the plan, and runs the matching command.
npx -y tokrepo@latest install ee491b17-39f1-11f1-9bc6-00163e2b0d79 --target codexRun after dry-run confirms the install plan.
What it is
Calibre-Web is a self-hosted web application that wraps around your existing Calibre eBook database and exposes it through a clean browser-based UI. Instead of requiring the Calibre desktop app on every machine, you run Calibre-Web on a server and access your entire library from phones, tablets, or laptops.
It is built for avid readers, home lab enthusiasts, and small teams who want a private eBook server without relying on commercial cloud services.
How it saves time or tokens
Calibre-Web eliminates the need to manually sync eBook files across devices. Once configured, any device with a browser can browse, search, and download books from the shared library. Metadata editing, format conversion (via Calibre binaries), and OPDS feed support reduce the manual overhead of maintaining a personal library.
How to use
- Install Calibre-Web via Docker or pip, pointing it at your existing Calibre
metadata.dbfile. - Configure user accounts, permissions, and optional LDAP or OAuth authentication.
- Access the web UI on port 8083 (default) and start browsing, reading, or downloading books.
Example
# docker-compose.yml for Calibre-Web
version: '3'
services:
calibre-web:
image: lscr.io/linuxserver/calibre-web:latest
environment:
- PUID=1000
- PGID=1000
- TZ=UTC
volumes:
- ./config:/config
- ./books:/books
ports:
- 8083:8083
restart: unless-stopped
Related on TokRepo
- Self-hosted tools -- Browse more self-hosted applications curated on TokRepo.
- Automation tools -- Discover automation workflows that pair well with home lab setups.
Common pitfalls
- Forgetting to point Calibre-Web at a valid
metadata.dbfile causes a blank library on first launch. - Running Calibre-Web and the Calibre desktop app simultaneously against the same database can corrupt metadata. Use one writer at a time.
- Default admin credentials (admin/admin123) must be changed immediately to prevent unauthorized access.
- Large libraries with thousands of books may need SQLite WAL mode enabled for acceptable read performance.
- OPDS feed URLs are case-sensitive in some reader apps; double-check the exact endpoint path.
Frequently Asked Questions
Calibre is a desktop application for managing eBook metadata, converting formats, and organizing libraries. Calibre-Web is a separate project that reads the same database but serves it through a web interface, letting you access books from any browser without installing the desktop app.
Yes, if you install the Calibre command-line binaries on the same server. Calibre-Web calls them to convert between EPUB, MOBI, PDF, and other formats on demand. Without those binaries, conversion is unavailable but browsing and reading still work.
Calibre-Web can send books to Kindle via email using the built-in Send-to-Kindle feature. You configure your SMTP settings and Kindle email address in the admin panel. It also supports MOBI and AZW3 downloads for manual sideloading.
Place Calibre-Web behind a reverse proxy like Nginx or Caddy with HTTPS. Enable authentication, disable public registration, and consider adding IP-based rate limiting. For extra security, use a VPN or Cloudflare Tunnel instead of exposing the port directly.
Yes. Calibre-Web supports multiple user accounts with per-user permissions. Each user gets their own reading progress, shelves, and download history. An admin can restrict which users can upload, edit metadata, or access specific categories.
Citations (3)
- Calibre-Web GitHub— Calibre-Web provides a web interface for Calibre libraries
- LinuxServer Calibre-Web Docs— Docker deployment via LinuxServer.io image
- Calibre Official— Calibre eBook management suite
Related on TokRepo
Discussion
Related Assets
Calibre-Web-Automated — Self-Hosted eBook Library with Auto Import and Conversion
An enhanced fork of Calibre-Web that adds automatic book importing, format conversion, and metadata enrichment for a fully hands-off eBook management experience.
Flatnotes — Self-Hosted Database-Free Markdown Notes
Flatnotes is a lightweight, self-hosted note-taking web app that stores notes as plain Markdown files in a flat folder — no database required, with full-text search and TOTP authentication.
pywebview — Lightweight Python GUI with Web Technologies
A cross-platform Python library that creates native GUI windows with embedded web views, letting you build desktop applications using HTML, CSS, and JavaScript for the frontend with Python for the backend.
Cinny — Self-Hosted Matrix Client for Encrypted Chat
Cinny is a sleek, open-source Matrix client with end-to-end encryption, custom themes, and full self-hosting support for private team communication.