0.26.0

Welcome to the 0.26.0 release of Karakeep! This release focuses on user management, servers improvements, and lots of fixes. We’ve a new comprehensive usage stats, reader mode, search history, S3 support, and much more. As always, we have amazing contributors in this release: @xuatz, @Ashok28, @HarryPeach, @Mostafa-Wahied, @adumat, @alexjsp, @apo-mak, @birnam, @deepanshu2711, @hametovbr, @irobot, @kdwils, @lexafaxine, @maelp, @rodsnts, @sheyabernstein, @simplytoast1, @thiswillbeyourgithub, @vhsdream!

If you enjoy using Karakeep, consider supporting the project here ☕️ or via GitHub here.

Managed Karakeep ☁️

I have some news to share! With Pocket shutting down, I’ve been thinking about how to make Karakeep more accessible to a wider audience. So I’ve decided to start the journey of offering a managed karakeep instance to serve those who can’t selfhost. Karakeep wouldn’t be where it is today without its amazing self-hosting community, and that will always remain my first priority. This managed offering is just an experiment. If it works, it could help support the development of the project. We’re now starting a private beta, and you can join the waitlist here!

New Features 🚀

• User Management & Authentication:
  • Added email verification support for new user registrations
  • Implemented password reset and forgot password functionality
  • Added user invitation system
  • Revamped signin/signup pages with better UX
  • Added per-user bookmark count / storage quotas
  • New delete account feature for users who want to remove their data
• Search History: You’ll now get search suggestions from your karakeep search history (#1627 by @lexafaxine)
• File Upload Support: Added markdown file upload support (#1672 by @rodsnts)
• Usage Statistics: New user stats page showing tons of stats about your bookmarks and usage of karakeep (#1523)
• New Reader Mode: A new revamped reader mode with customizable font type and size (got jealous of how that of linkwarden looked!)
• Proxy Support: Added proper proxy support for crawler network requests (#1265)
• Server Improvements:
  • S3 Storage Support: Option to store assets in S3-compatible storage (#1703)
  • Prometheus Monitoring: We’re now exposing a Prometheus endpoint for monitoring stats about the server (#758)
  • Rate Limiting: Added optional API rate limiting
  • Large HTML content now stored in asset storage (instead of db) for better performance
  • Allow enabling WAL mode on the database (opt-in, recommended)
  • Allow customizing parallelism for workers (#724)
• Reddit Crawling: Reddit posts will now get a more relevant banner image (#1302 by @birnam)

UX Improvements ✨

• Prioritize crawling user-added links over bulk imports (#1717)
• Mobile app now has user setting for default bookmark view mode (#1723 by @xuatz)
• More lenient JSON parsing for LLM responses (#1267)
• Tweaks to mobile app icon padding with iOS tinted variant (#1620 by @alexjsp)
• Minor styling changes to the “All Tags” page
• Added icons to bookmark preview selectors
• Clicking on search tooltip now opens the search language guide (#1540)
• Added confirmation dialog for user deletion in admin panel (#1649 by @deepanshu2711)
• Added tag clearing functionality to tag list in the mobile app(#1595 by @Ashok28)
• Always visible search bar in the mobile app’s tags list (#1596 by @Ashok28)

Fixes 🔧

• Fixed OAuth creation failure due to missing UserSettings table (#1583)
• Fixed webhook not firing on deletion (#1613)
• Normalized leading hashes in tag names (#1351 by @Mostafa-Wahied)
• Fixed import/export icons being swapped (#1682 by @HarryPeach)
• Disabled metascraper readability plugin that was causing worker stuckness
• Fixed jsdom console logs leaking into worker logs
• Collapsed long runs of repeated whitespaces before tokenization to speed it up (#1622)
• Fixed public image signed tokens for better caching
• Fixed clear parent button in edit list dialog (#1742)
• Fixed running workers in production without tsx for lower resource usage (#1673)
• Fixed get-lists MCP tool (#1697 by @hametovbr)
• Fixed image quality slider in mobile showing excessive decimal places (#1735)
• Fixed mobile app crash when bookmark doesn’t have archive or screenshot (#1584)
• Migrated from Puppeteer to Playwright (#1296 by @maelp)
• Video downloader now properly logs yt-dlp errors (#1624 by @irobot)

For Developers 🛠️

• Added Helm chart support (link). (#1350 by @sheyabernstein)
• Build & Deployment:
  • A much fancier linux installation script (#1576 by @vhsdream)
  • Added start-dev.sh script for easier development (#1628 by @xuatz)
  • Upgraded to pnpm@9.15.9 (#1544 thanks to @xuatz)
  • Migrated from ESLint to oxlint for faster linting (#1642 by @xuatz)
  • We now have a CLAUDE.md file to help the vibe coders out there.

Community Projects 💡

Karakeeper

3rd Party Safari Extension - by @simplytoast1

Karakeep Homedash

by @CodeJawn

Screenshots 📸

Usage Stats

The new Sign In page

Recent Searches

Reader Mode

Upgrading 📦

To upgrade:

• If you’re using KARAKEEP_VERSION=release, run docker compose pull && docker compose up -d.
• If you’re pinning it to a specific version, upgrade the version and then run docker compose pull && docker compose up -d.

Note: This release includes database schema changes. The migration will run automatically on startup.

All Commits

• fix(web): Remove horizontal scroll in PWA’s header - @MohamedBassem in 202924c9
• feat(web): Slightly nicer looking tags page - @MohamedBassem in 61a6ac83
• fix: Run workers in prod without tsx. Fixes #1673 - @MohamedBassem in 2cce45b7
• deps: bump s6-overlay version (#1750) - @adumat in 4fe541c4
• fix: Fix edit list modal not clearing parent - @MohamedBassem in b992fadd
• feat: Add a proper reader mode - @MohamedBassem in 49f38efd
• fix: Increase crawler max worker count in tests - @MohamedBassem in 4a4ff37b
• feat: Allow setting browserless crawling per user - @MohamedBassem in 4e9544b0
• feat: Allow enabling journaling mode on the db - @MohamedBassem in 64a0d918
• fix(mobile): Fix image quality slider showing lots of decimal places. fixes #1735 - @MohamedBassem in ae1352f3
• fix: Rename the proxy settings such that they don’t interfer with other requests - @MohamedBassem in 1da8b458
• chore: Move the helm charts to their own repo - @MohamedBassem in f3feb599
• fix(web): Fix the clear parent button in the edit list dialog. Fixes #1742 - @MohamedBassem in 8bd3b586
• feat(mobile): Add user setting for default bookmark view mode (#1723) - @xuatz in fe69ca8c
• fix: Clear search history on logout - @MohamedBassem in a3627569
• feat: adding search history #1541 (#1627) - @lexafaxine in 39fcda01
• feat: markdown file upload support (#1647) (#1672) - @rodsnts in ecb13cec
• Revert “fix: Fix the types of the bookmark types in the db query” - @MohamedBassem in 0addc7bc
• fix: Fix the types of the bookmark types in the db query - @MohamedBassem in 4ba3e804
• feat: Add stripe based subscriptions - @MohamedBassem in d1d52634
• feat: Add delete account support - @MohamedBassem in 845ccf1a
• fix: Drop auth failure logger - @MohamedBassem in f8ae9866
• feat: Add proper proxy support. fixes #1265 - @MohamedBassem in 360ef9db
• feat(api): Expose the update user API in the openapi specs - @MohamedBassem in 1105b4a4
• build: Restrict claude actions invocations - @MohamedBassem in ba7a87fe
• fix(web): Fix the alignment in the user options page - @MohamedBassem in 49648c4c
• deps: Upgrade typescript to 5.8 - @MohamedBassem in 6b77736b
• fix: Add ratelimiting to bookmark recrawl and summarization - @MohamedBassem in 21076b83
• deps: Upgrade drizzle - @MohamedBassem in f4436e19
• fix(web): Fix dark mode in auth pages - @MohamedBassem in 92311191
• fix(tests): Fix missing mock in trpc tests - @MohamedBassem in 8c3bf481
• fix: Prioritize crawling user added links over bulk imports. fixes #1717 - @MohamedBassem in 9fb3ef6f
• refactor: Move db interactions into the trpc routes - @MohamedBassem in 8e3013ba
• feat: Support forget and reset password - @MohamedBassem in 140311d7
• chore: Add claude code github action - @MohamedBassem in 385f9f0b
• feat(ui): Revamp the signin/signup page - @MohamedBassem in db9a02b8
• feat: Add API ratelimits - @MohamedBassem in 613137ff
• feat: Add invite user support - @MohamedBassem in 333d1610
• feat: Add support for email verification - @MohamedBassem in 93049e86
• fix(api): Fix handling for CORS after the trpc move to hono. Fixes #1709 - @MohamedBassem in aae3ef17
• fix: Drop the need to for the self-call for providers and NEXTAUTH_INTERNAL_URL - @MohamedBassem in f7f577af
• feat: Add a logout page - @MohamedBassem in bb4a687b
• fix: Add a dummy bcrypt comparison in validatePassword when the user is not found - @MohamedBassem in 58488e1c
• build: Add an open-api husky check - @MohamedBassem in 71458166
• fix(build): Regenerate openapi spec - @MohamedBassem in 0eeefd68
• fix: Fix search indexing after content split - @MohamedBassem in f5a674c2
• fix(web): Clicking on search tooltip opens the search language guide. Fixes #1540 - @MohamedBassem in f3b925ad
• feat: Store large html content in the asset db - @MohamedBassem in dee3a4d4
• fix(mobile): Fix crash when bookmark doesn’t have archive or screenshot. Fixes #1584 - @MohamedBassem in 362be300
• fix(tests): Fix broken user setting test - @MohamedBassem in 959da9a8
• chore: Excluded unneeded docker context using dockerignore - @MohamedBassem in 5c8a2b9b
• feat: Add a new timezone user setting - @MohamedBassem in 0e94ad36
• feat: Add prometheus monitoring. Fixes #758 - @MohamedBassem in b60ece57
• fix(build): Regenerate openapi spec - @MohamedBassem in cfa0385b
• fix: Fix i18n in the new stats page - @MohamedBassem in f96680fc
• feat: Add per user storage quota - @MohamedBassem in 384432d3
• feat: Add new user stats page. Fixes #1523 - @MohamedBassem in 47624547
• feat(workers): Allow custmoizing max parallelism for a bunch of workers. Fixes #724 - @MohamedBassem in 5576361a
• feat: Add support for S3 as an asset storage layer (#1703) - @MohamedBassem in d66b3b86
• fix(workers): A more lenient JSON parsing for LLM responses. Fixes #1267 - @MohamedBassem in 53b6b3c2
• refactor: Move the health endpoint to hono as well - @MohamedBassem in f144f1bc
• refactor: Move the trpc endpoint to hono - @MohamedBassem in f5e737bf
• chore: Symlink Gemini.md to CLAUDE.md - @MohamedBassem in 474ca7f2
• feat: Add per user bookmark count quota - @MohamedBassem in 545cac19
• chore: Symlink Gemini.md to AGENTS.md - @MohamedBassem in 73a0c951
• fix(web): Add icons to preview selectors - @MohamedBassem in ad92fa24
• chore: Add a GEMINI.md file for people using gemini-cli - @MohamedBassem in 4776b4cd
• fix(mcp): add empty params object (#1697) - @hametovbr in 6cc249d1
• fix: switch import / export icons (#1682) - @HarryPeach in 7febebe1
• fix(workers): Disable the metascraper readability as it’s causing slowness in worker - @MohamedBassem in 71f8e970
• fix(workers): Fix jsdom console logs leaking into worker logs - @MohamedBassem in b74377d2
• feat(workers): adding a local metascraper plugin for Reddit posts (#1302) - @birnam in 7cc4b08a
• fix(tags): normalise leading hashes in tag names (#1317) (#1351) - @Mostafa-Wahied in 112aa9d9
• feat(workers): migrate from puppeteer to playwright (#1296) - @maelp in c70d64d4
• feat(mobile): Add tag clearing functionality to tag list (#1595) - @Ashok28 in 727c7f22
• fix(mobile): always visible search bar in tags list (#1596) - @Ashok28 in 4134649d
• fix: minor changes to the tagging prompts (#1474) - @thiswillbeyourgithub in a74afc9d
• build: Install script v3.0 - Bling version (#1576) - @vhsdream in e310ba9f
• feat: Add Helm chart (#1350) - @sheyabernstein in 43d3210b
• chore: More oxlint changes - @MohamedBassem in f7b31938
• chore: migrate away from eslint to oxlint (#1642) - @xuatz in d5e2973d
• docs: update meilisearch key generation instruction (#1651) - @kdwils in 91a9d3c1
• fix: Fix webhook not firing on deletion. Fixes #1613 - @MohamedBassem in 04f93941
• feat(admin): add confirmation dialog for user deletion (#1648) (#1649) - @deepanshu2711 in 0f4c6162
• fix: Collapse long runs of repeated whitespaces before tokenization to avoid choking the tokenizer. Fixes #1622 - @MohamedBassem in 426beff1
• fix: Change public image’s signed tokens to be time aligned for better caching - @MohamedBassem in 10d45e8d
• fix: Fix oauth creation failure due to missing UserSettings table. Fixes #1583 - @MohamedBassem in f1f665f8
• fix(mobile): tweaks to mobile app icon padding + added iOS tinted variant (#1620) - @alexjsp in 6c0bcca1
• fix(workers): video downloader should log yt-dlp errors (#1624) - @irobot in a16c5424
• chore: add start-dev.sh for laziness (#1628) - @xuatz in 88e4ea98
• i18n: Add Greek translation (#1564) - @apo-mak in 004eb5ad
• docs: Mention the community safari extension in the quick sharing docs (#1562) - @simplytoast1 in e5307f19
• release(cli): Bump CLI version to 0.25.0 - @MohamedBassem in bb00699b
• build: Pin ios github action to macos-15 to comply with apple’s requirement for min ios SDK - @MohamedBassem in d7617cc2
• fix: Fix UI infinite recursion by upgrading radix packages - @MohamedBassem in 675ed5c3