MyBibliotheca 3.0.0
STABLE · POSTGRESQL
MyBibliotheca is a self-hosted library manager and reading tracker. Version 3.0.0 uses PostgreSQL as its primary database. Existing Kuzu installations must use the in-app migration wizard to move their library; upgrading the app alone does not migrate data.
Looking for the hosted reading tracker?
These pages document the self-hosted edition. Visit MyBibliotheca Cloud to use the hosted reading tracker without managing a server.
Back up before upgrades and migration
Keep a recent backup before upgrading or migrating. For Kuzu-to-PostgreSQL moves, follow every step in the migration wizard guide.
Choose a guide
| If you want to… | Start here |
|---|---|
| Install or upgrade | Install & upgrade |
| Import books | Import books |
| Find missing ISBNs or covers | Repair metadata |
| Search, organize, or edit books | Library & metadata |
| Record reading and view statistics | Reading & analytics |
| Manage users and server settings | Administration |
| Back up or restore the library | Backups & restore |
| Connect OPDS or Audiobookshelf | Integrations |
| Diagnose a problem | Troubleshooting |
Stable release facts
- Version: 3.0.0
- Primary database: PostgreSQL
- Legacy database migration: guided in-app Kuzu-to-PostgreSQL wizard
- Runtime: Python 3.13+ when running from source
- Recommended deployment: Docker Compose
- Persistent data: PostgreSQL volume and
/app/data, normally mounted from./data - Optional cache: Redis
- Metadata providers: Google Books and OpenLibrary, subject to availability and rate limits
A quick mental model
MyBibliotheca keeps bibliographic information—such as title, contributors, ISBNs, series, categories, and covers—separate from personal information such as reading status, dates, notes, ratings, and personal custom fields. This lets shared books work with private reading data for each user.
Documentation conventions
- Admin-only means the action requires an administrator account.
- Personal means the value belongs to one user and is not automatically shared.
- Shared book metadata means an update may be visible to every user who can see that book.
- Needs Review marks a book for follow-up; it is not a failure that prevents the rest of an import.