Skip to main content

Self-Hosted Book Management

One library for your digital books

Shisho is an open-source, self-hosted system that brings supported ebooks, audiobooks, and comics together in a unified library.

From supported files to a searchable library

Shisho scans compatible files, extracts available metadata, and gives you tools to review and manage the resulting library.

1

Mount your supported books

Mount a directory of supported ebooks, audiobooks, or comics. Shisho scans the folder and imports compatible files. Moving and renaming files is an optional library setting.

2

Metadata is extracted and enriched

Shisho extracts format-specific metadata from each file. Optional metadata enricher plugins can match books against online sources.

3

Read, listen, or download

Use the browser, Kobo sync, OPDS, or direct downloads from devices that can reach your Shisho server.

Native support for popular book formats

Capabilities vary by format, including metadata extraction, browser reading, and generated downloads. See the complete Supported Formats guide.

Ebooks
EPUBPDF
Audiobooks
M4B
Comics
CBZ

Everything you need to manage your library

Choose the guide for your task: use Shisho, administer a deployment, connect through OPDS, Kobo Sync, or the eReader Browser, or develop plugins.

Unified Library

Ebooks, audiobooks, and comics all live together. Browse by series, author, genre, or format from one interface.

Self-Hosted & Private

Shisho runs on hardware you control with no required subscription. Enabled plugins and integrations may connect to services you configure.

Rich Metadata

Extract format-specific titles, contributors, series, covers, languages, chapters, and identifiers, then review or edit them.

Kobo Sync & OPDS

Sync books directly to your Kobo e-reader with automatic KePub conversion. OPDS catalog for any compatible reader app.

Multi-User & Permissions

Create users with Admin, Editor, or Viewer roles. Control access per library with fine-grained permissions.

Plugin System

Extend functionality with JavaScript plugins for format conversion, metadata enrichment, and custom integrations.

Start with the deployment checklist

Shisho runs as a Docker container. Before starting, review the complete deployment steps for persistent storage, a strong JWT secret, and host file permissions.

Review and adapt the compose file

Set persistent paths and mount the library at the container path you plan to configure in Shisho.

Set the secret and permissions

Generate a JWT secret and match PUID and PGID to the host account that owns the mounted files.

Start Shisho and create a library

Start the container, visit port 5173, and create a library using the mounted container path.

Ready to build your Shisho library?

Shisho is free and open source.