selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

BookHeaven.Server logo

Self-host BookHeaven.Server

v1.0.1

Ebook library manager with OPDS and KOReader sync

BetaOpen SourceGPL-3.0
Updated9 hours ago
LanguageHTML
Setup difficultyEasy
MobileResponsive
Stars
190
Ports
8080 (web ui), 27007 (auto discovery (UDP))
Docker
ghcr.io/bookheaven/bookheaven-server
Install with Docker
Profiles screenShelf viewBook pageBook editingSettingsFont management

What is BookHeaven.Server?

BookHeaven Server is a self-hosted web application for managing your ebook library. It lets you organize books into authors, series, collections, and tags, with metadata read from and written back to the ebook files. Features include an OPDS catalog at /opds/v1, KOReader sync compatibility, reading progress tracking with timestamps and percentages, font management for devices, and multiple user profiles to keep reading progress separate. It runs via Docker, Docker Compose, or Podman with an embedded SQLite database and requires a persistent data volume. The project is open-source under GPL-3.0 and includes a companion Android reader app.

Should you self-host BookHeaven.Server?

BookHeaven.Server scores 44/100 on selfhost.directory (how scoring works) and ranks #11 of 19 in Ebook Management. It has 190 GitHub stars.

It shipped 15 stable releases in the past year. The latest, v1.0.1, came out on 27 October 2026. New versions land roughly every 8 days.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is GPL-3.0-licensed and written mostly in HTML.

Its closest alternative on selfhost.directory is Calibre (83/100, 26 267 stars). It scores higher overall, so compare the two before you pick. See BookHeaven.Server vs Calibre side by side.

Features

  • Auto discovery
  • Ebook library management
  • Font management
  • Import folder
  • KOReader Sync
  • Metadata Fetching
  • Metadata handling
  • Multi-language UISpanish features might release without translation for a while
  • Multiple Profiles
  • OPDS Catalog
  • Progress Tracking
  • REST API

BookHeaven.Server README

How to install BookHeaven.Server

Install BookHeaven.Server with Docker

Docker
Environment variables
SERVER_URL, TZ

docker run -d --name bookheaven --user 1000:1000
-p 8080:8080 -p 27007:27007/udp
-v $PWD/data:/app/data
-v $PWD/import:/app/import
-e SERVER_URL=https://bookheaven.yourdomain.tld
ghcr.io/bookheaven/bookheaven-server:latest

Avoid mapping /app/data to a network share due to SQLite issues

How to configure BookHeaven.Server

  • SERVER_URLRequired for auto discovery, change to your desired domain or ip:port, including the protocol (http or https)

    Required for auto discovery, change to your desired domain or ip:port, including the protocol (http or https)

  • TZEurope/MadridTimezone for the container

    Timezone for the container

BookHeaven.Server releases & version history

More in Ebook Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…