BookHaven

GPL-3.0
Platform
Web Docker Self-hosted
Licence
GPL-3.0 Open source
BookHaven

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.

Explore More Categories

Sign In

Register

Reset Password

Please enter your username or email address, you will receive a link to create a new password via email.