BookBoss

Take Control Of Your Digital Library

BookBoss is a self-hosted application for managing your e-book collection. It provides a web-based interface for organising, browsing, and syncing your library across devices — backed by PostgreSQL, MySQL, MariaDB, or SQLite.

For Users

New to BookBoss? Start here:

• Installation — set up BookBoss on your server or machine
• Getting Started — first run, admin account setup
• Database Configuration — choose and configure your database backend
• Managing Your Library — importing books, browsing, editing metadata
• Shelves & Reading State — organise books into shelves, track reading progress
• Libraries — virtual collections for multi-user installs
• OPDS Catalog — browse your library from any OPDS-compatible reader app
• Kobo Device Sync — sync books and reading progress with Kobo e-readers
• Configuration Reference — all available configuration options

For Contributors

Looking to contribute or run from source?

• Architecture — hexagonal design, crate layout, domain modules
• Development Setup — tools, environment, first build
• Commands — all just commands
• Conventions — commits, error handling, testing, secrets
• Frontend (Dioxus) — server functions, routing, auth, SSE events
• Database Internals — SeaORM, migrations, entity generation