Critical Upgrading Notes (v0.31.0 → v0.34.1)
- Authentication Migration to Better Auth:
- Karakeep migrated its auth library from next-auth to better-auth.
- All web users must log in again after upgrading. Mobile app sessions and API keys remain unaffected.
- Important database check: If your database contains accounts with email addresses that differ only in casing (e.g., User@example.com vs user@example.com), clean or merge them prior to upgrading to prevent login failures. [1, 2, 3]
- Browserless → Karakeep-Chrome Migration:
- Admin Password Reset:
- Admin password reset instructions were updated to accommodate better-auth (see docs inside the repo if needed). [1]
Key Highlights Between v0.31.0 and v0.34.x
- Mobile App Feature Parity (v0.33.0 / v0.34.0):
- Offline downloads: Automatic background downloading of recent bookmarks and designated lists for offline access.
- Layouts & Navigation: Native tabs, tablet multi-column support, and a new default compact list view (with toggle options).
- Tag & List Management: Ability to rename/delete tags, manage public lists, and handle list collaborators directly from the mobile app.
- Clipboard & Sorting: One-tap clipboard saving and newest/oldest sorting controls. [1, 2]
- Crawler & Anti-Bot Overhaul (v0.34.0):
- The crawler now drives real Google Chrome via patchright, significantly reducing anti-bot block pages (“Just a moment…”). [1]
- Performance & Memory Optimizations (v0.34.0):
- Fixed a server query cache memory leak and optimized lazy-loading, dropping resident memory usage by roughly 40MB on typical Docker deployments.
- Improved SQLite database speed, tag search, batch indexing, and reduced base CPU usage when Prometheus is disabled. [1]
- Search & UI Enhancements:
- New search filters: has:notes and has:highlights.
- Dead/failed link management page redesign with search and batch delete.
- Automatic conversion of web images to WebP to save storage.
- System-following dark mode support in the web interface. [1]