BookHaven

BookHaven is a web-based EPUB library manager and in-browser reader that scans, indexes, and serves a local collection of EPUB ebooks. It provides a responsive UI for browsing, searching, reading, downloading, and managing ebook metadata across devices.

Key Features

• Read EPUB ebooks directly in the browser with a responsive, modern interface
• OPDS feed support for use with OPDS-compatible e-reader apps
• Non-destructive metadata editing (changes stored in the database by default)
• Automatic and manual library scanning with locking to avoid concurrent scans
• Uploads via web UI and post-upload metadata editing workflow
• Basic role-based access control (RBAC) with configurable user roles
• Optional OIDC authentication and Cloudflare Access bypass flag
• Configurable storage with support for MySQL, PostgreSQL, or SQLite and Redis for caching
• Image processing using pyvips and Redis caching for media endpoints to improve performance
• Docker Compose friendly deployment and separate frontend build (Node/TypeScript)

Use Cases

• Centralize a personal or household EPUB collection for browser access and downloads
• Serve an OPDS catalog to mobile e-reader apps while managing metadata centrally
• Provide shared reading access with role-based permissions for small groups or teams

Limitations and Considerations

• Primary format support is EPUB; other ebook formats have limited or no native support
• Search is designed for filtering by author, title, and series; full-text or advanced indexing may require external tooling
• Performance for very large libraries depends on DB choice, Redis caching, and host resources

BookHaven is focused on offering a simple, self-hosted EPUB library with web reading, OPDS access, and metadata management. It is designed for easy Docker deployment and local network or private cloud usage.