BookHeaven/BookHeaven.Server

O que é?

Recursos principais

• 01Organize livros por autor, série, coleção e tags
• 02Edite metadados e capas, com as alterações gravadas no próprio arquivo de ebook
• 03Busque capas e metadados na internet
• 04Acompanhe o progresso de leitura por perfil, com ajuste manual
• 05Feed OPDS em /opds/v1 e suporte ao KOReader Sync
• 06Detecção automática do servidor pelo app Android BookHeaven Reader

Casos de uso

• Hospedar uma biblioteca pessoal de ebooks em um servidor doméstico e acessá-la em vários dispositivos
• Disponibilizar um catálogo OPDS para apps de leitura compatíveis
• Sincronizar o progresso de leitura entre o KOReader e um servidor central
• Gerenciar fontes personalizadas para dispositivos usados para ler seus livros

Início rápido

1. 1

   Baixe a imagem do contêiner do GitHub Container Registry

   docker pull ghcr.io/bookheaven/bookheaven-server:latest
2. 2

   Inicie o servidor com Docker run, mapeando a porta da interface web e a pasta de dados

   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
3. 3

   Abra a interface web no navegador pela porta 8080

Antes de usar

• !Não é recomendável armazenar a pasta de dados em um compartilhamento de rede porque o sistema usa SQLite.

Em coleções

Tópicos

Perguntas frequentes

O que é BookHeaven.Server?

Servidor web auto-hospedado para gerenciar sua biblioteca de ebooks, com OPDS, KOReader Sync e uma API para o app Android BookHeaven Reader. O BookHeaven Server é uma aplicação web para organizar e ler uma biblioteca de ebooks na sua própria máquina. Ele agrupa os livros por autor, série e coleção, oferece suporte a tags e lê os metadados diretamente de cada arquivo de ebook. As alterações em títulos, autores ou capas são gravadas no próprio arquivo, e também é possível buscar capas e metadados na internet.

BookHeaven.Server é gratuito? Qual é a licença?

BookHeaven.Server é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

BookHeaven.Server ainda é mantido?

Manutenção ativa. O último commit de BookHeaven.Server foi em 5 de nov. de 2026.

Para que posso usar BookHeaven.Server?

Hospedar uma biblioteca pessoal de ebooks em um servidor doméstico e acessá-la em vários dispositivos Disponibilizar um catálogo OPDS para apps de leitura compatíveis Sincronizar o progresso de leitura entre o KOReader e um servidor central Gerenciar fontes personalizadas para dispositivos usados para ler seus livros

Como instalar BookHeaven.Server?

Baixe a imagem do contêiner do GitHub Container Registry: docker pull ghcr.io/bookheaven/bookheaven-server:latest Inicie o servidor com Docker run, mapeando a porta da interface web e a pasta de dados: 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 Abra a interface web no navegador pela porta 8080

Onde consigo BookHeaven.Server?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/BookHeaven/BookHeaven.Server