BookHaven
GPL-3.0
- Platform
- Web Docker Self-hosted
- Licence
- GPL-3.0 Open source
BookHaven is a self-hosted web reader for a library of EPUB ebooks you already own. It scans a folder of EPUB files, reads the metadata already inside them, and serves the collection through a browser interface where you can search, filter, read online and download to any device — no desktop application on every machine and no cloud account.
What it does
- Read in the browser — EPUBs open in the built-in reader, so phones, tablets and locked-down work laptops need nothing installed.
- Download any book — take the original EPUB back out for an e-reader app of your choice.
- Non-destructive metadata editing — corrections to title, author or series are stored in the database; the EPUB file on disk is never rewritten.
- Automatic and manual scans — the library is rescanned on a configurable interval and on demand, so new files appear without a restart.
- Browse by author and series — an alphabetical author index, per-author pages sorted by series, plus favourites and finished/unfinished filters.
- Uploads and book requests — users can add ebooks through the interface and request missing titles; admins and editors resolve the queue.
- OPDS catalogue — any OPDS-compatible reader can browse, download and read from the library.
- Multi-user access control — role-based permissions, optional OIDC login for existing accounts, and a bypass for instances sitting behind Cloudflare Access.
Running it
A Docker image with an example Compose file is the documented deployment route. The application needs a database (MySQL, PostgreSQL or SQLite) and a Redis instance, both provided in the example stack; point BASE_DIRECTORY at the folder holding the EPUBs, set COVER_BASE_DIRECTORY for generated covers, and give it an admin email and password. The first scan indexes whatever is already there, and the same session can serve the whole household or a small club library.
Alternatives
- Calibre-Web — the long-standing web front end for a Calibre library, with conversion and metadata editing handled by Calibre itself.
- BookHeaven Server — a similarly named but separate project; BookHaven reads a plain EPUB folder and has no Calibre dependency.
- BookWyrm — federated social reading rather than a personal library server.
- Kavita — server and reader aimed at comics and manga as well as ebooks.
Views: 3