# Calibre-Web Ebook Server

> Self-hosted ebook library with web-based reader, OPDS feed support, and Calibre database integration for managing your digital book collection.

- Category: Media & Entertainment
- Difficulty: beginner
- Components: calibre-web
- Tags: ebooks, calibre, library, reading, opds
- Source: https://docker.recipes/media/calibre-web-stack

## Overview

Calibre-Web is a web-based application that provides a clean, modern interface for browsing and reading ebooks stored in a Calibre database. Originally developed as an alternative frontend to Calibre's built-in content server, Calibre-Web offers enhanced features like user management, custom shelves, reading progress tracking, and OPDS catalog support for e-reader integration. The application transforms your local Calibre library into a full-featured ebook server accessible from any device with a web browser. This Docker stack combines Calibre-Web with the LinuxServer.io Calibre modification, enabling direct ebook format conversion and metadata editing without requiring a separate Calibre installation. The configuration creates a self-contained ebook server that can manage thousands of books while providing features like send-to-Kindle functionality, goodreads integration, and advanced search capabilities. This setup is ideal for book enthusiasts, families sharing ebook collections, educational institutions managing digital libraries, and anyone seeking to centralize their ebook collection with professional library management features while maintaining complete control over their digital books.

## Features

- Web-based ebook reader supporting EPUB, PDF, CBR, CBZ and other formats with customizable reading settings
- OPDS catalog feed generation for direct integration with e-reader devices and mobile reading applications
- Built-in ebook format conversion using integrated Calibre engine for transforming between EPUB, MOBI, PDF and other formats
- Send-to-Kindle email functionality for wireless ebook delivery to Amazon Kindle devices
- User management system with reading progress synchronization and personal bookshelves
- Goodreads integration for book ratings, reviews, and metadata enhancement
- Advanced search and filtering with support for custom columns and metadata fields
- Kobo e-reader synchronization for reading progress and library updates

## Use cases

- Personal digital library management for organizing and accessing ebook collections across multiple devices
- Family ebook sharing with individual user accounts and reading progress tracking
- Educational institutions providing students access to digital textbooks and course materials
- Book clubs and reading groups sharing recommended titles and discussion materials
- Small libraries and community centers offering digital book lending services
- Remote workers and travelers accessing their book collection from any location
- Publishers and authors distributing review copies and advance reader copies to reviewers

## Prerequisites

- Existing Calibre library with metadata.db file or willingness to create new library structure
- 512MB available RAM for basic operation, 1GB+ recommended for large libraries over 1000 books
- Port 8083 available on host system for web interface access
- Basic understanding of ebook formats and metadata management concepts
- Storage space adequate for ebook collection plus 20% overhead for conversion cache
- SMTP email server credentials if planning to use send-to-Kindle or notification features

## docker-compose.yml

```yaml
services:
  calibre-web:
    image: linuxserver/calibre-web:latest
    container_name: calibre-web
    restart: unless-stopped
    ports:
      - "${CALIBRE_PORT:-8083}:8083"
    environment:
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      - TZ=${TZ:-UTC}
      - DOCKER_MODS=linuxserver/mods:universal-calibre
    volumes:
      - calibre_config:/config
      - ${BOOKS_PATH:-./books}:/books

volumes:
  calibre_config:
```

## .env

```bash
# Calibre-Web Configuration
CALIBRE_PORT=8083
TZ=UTC
PUID=1000
PGID=1000

# Path to your Calibre library (must contain metadata.db)
BOOKS_PATH=./books
```

## Usage notes

- Access Calibre-Web at http://localhost:8083
- Default login credentials: admin / admin123
- On first login, set the Calibre database location to /books
- Your books directory must contain a Calibre metadata.db file
- Enable ebook conversion in admin settings for format conversion
- OPDS feed available at /opds for e-reader sync

## Troubleshooting

- Database not found error on first access: Ensure books directory contains valid Calibre metadata.db file or create empty library using Calibre desktop application
- Ebook conversion fails with permission errors: Verify PUID and PGID environment variables match ownership of books directory on host system
- OPDS feed returns empty results: Check that books have proper metadata and covers, regenerate thumbnails in admin settings
- Send-to-Kindle emails not delivered: Configure SMTP settings in admin panel and verify Kindle email addresses are authorized in Amazon account settings
- Web interface loads slowly with large libraries: Increase container memory allocation and enable database optimization in admin settings
- Unable to upload new books: Ensure config volume has write permissions and sufficient disk space for temporary file processing

