Your personal digital library
Nanahoshi is a modern, self-hosted library server for managing and reading your book collection with full-text search, metadata management, and multi-tenant support.
Quick Start
Get your library running in minutes with Docker
Clone and configure
Clone the repository and set up your environment:Edit
.env with your configuration (database, secrets, SMTP settings).Start the services
Launch the full stack with Docker Compose:This starts the web app (port 3001), API server (port 3000), PostgreSQL, Redis, and Elasticsearch.
Create your library
Navigate to http://localhost:3001, create an account, and add your first library pointing to your book directories.
Mount your book directories as volumes in
docker-compose.yml before creating libraries.Key Features
Everything you need for a modern digital library
Full EPUB Support
Built-in reader with ttu-reader integration for seamless EPUB reading experience.
Advanced Search
Full-text search powered by Elasticsearch with Japanese Sudachi tokenizer support.
Multi-Tenant
Organizations and workspace support for sharing libraries across teams.
Metadata Management
Automatic metadata extraction from EPUB files with collections and series tracking.
Self-Hosted
Complete control over your data with Docker deployment and infrastructure.
Modern Stack
Built with TypeScript, Hono, React, and TanStack for type-safe development.
Explore the Documentation
Learn how to configure, deploy, and extend Nanahoshi
Core Concepts
Understand the architecture and data model
Deployment Guide
Production deployment with Docker
API Reference
Complete API documentation with examples
Library Management
Organize and scan your book directories
Authentication
User management and security
Contributing
Set up your development environment
Ready to build your library?
Start managing your book collection with Nanahoshi today. Deploy in minutes with Docker or set up a development environment.