Skip to content

Release history

mybibliotheca releases

Track your reading habits, log books, and visualize your library—all in your own space.

All releases

8 shown

2.1.0 Bug fix
⚠ Upgrade required
  • Default library sort order has changed to newest added first; reconfigure manually if title A-Z order is preferred.
  • Docker tag for this release is '2.1.0'. Install docs: https://mybibliotheca.org/stable/
Breaking changes
  • Default library sort order changed from title A-Z to newest added first — users or integrations depending on the previous default sort may see reordered results.
Notable features
  • Genre deletion now permitted even when books are associated with the genre
  • Search bar relocated for improved discoverability
  • Reading status badge display improvements
2.0.1 Security relevant
⚠ Upgrade required
  • Fixes a startup crash caused by the removed @app.before_first_request decorator in Flask 2.2+; users on Flask 2.2+ should upgrade immediately to avoid application startup failures.
  • Python packages updated to latest stable versions; review dependency changes if running a customized environment.
Security fixes
  • Removed sensitive user_data dict logging that exposed user fields in logs
Notable features
  • Pagination controls added at bottom of library view
  • Enhanced dark mode CSS with comprehensive Bootstrap utility class overrides
  • Improved reading journey calendar with larger book covers
v2.0.0 Breaking risk
⚠ Upgrade required
  • Version 1.1.1 is deprecated and will no longer receive maintenance; users must upgrade to 2.0.0
  • No default credentials are set — administrators must configure credentials on first install
  • Refer to install documentation at https://mybibliotheca.org/ for migration guidance
Breaking changes
  • Migrated from traditional SQL to KuzuDB graph database — existing data migration required
  • Version 1.1.1 is deprecated and that branch will no longer be maintained
Notable features
  • Multi-user support with bcrypt authentication and complete user data isolation
  • Admin tools for user management
  • ISBN book lookup with automatic metadata fetching
v2.0.0b Breaking risk
⚠ Upgrade required
  • Back up data before upgrading
  • Set WORKERS=1 in deployment configuration (mandatory)
  • V1.x users must follow migration guide available in documentation at mybibliotheca.org
Breaking changes
  • Full database migration from SQL to KuzuDB — existing V1.x users must follow migration guide
  • KuzuDB requires WORKERS=1; concurrent worker configurations will break
  • No horizontal scaling: single instance per database only
Notable features
  • KuzuDB graph database backend (foundation for future recommendations and social features)
  • Multi-user support with bcrypt password hashing and data isolation
  • Admin tools for user management
v1.1.1 New feature
⚠ Upgrade required
  • Back up your database (books.db) before upgrading — auto-migration adds missing columns.
  • A backup download button is available in the project footer.
  • Goodreads bulk import may crash the server for large libraries; consider splitting the file or using the new CSV bulk importer instead.
Notable features
  • Book metadata filtering (language, publisher, title)
  • Bulk CSV import (see test_files/test_bulk_import_upcs.csv for format)
  • Goodreads bulk import (retained)
v1.0.1 New feature
⚠ Upgrade required
  • Database storage now uses a named Docker volume instead of host folder mapping; existing data must be migrated using Docker CLI tools or SQLite3 commands within the container.
  • SSL is required with no built-in workaround; users must supply their own SSL certificates or route traffic through a Cloudflare tunnel.
Notable features
  • Docker support (arm64 and amd64)
  • Named volumes for database persistence (replaces host folder mapping)
  • Gunicorn production WSGI server replacing Flask dev server

Beta — feedback welcome: [email protected]