Skip to content

Releases: karakeep-app/karakeep

Release list

0.33.2

0.33.2 Latest
Latest

Choose a tag to compare

View all tags
@MohamedBassem MohamedBassem released this 11 Aug 13:30
Immutable release. Only release title and notes can be modified.
v0.33.2
98c0c78
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

0.33.2

This is a patch release for after 0.33.1. It contains the following fixes:

Bug fixes:

  • Change default "use max completion tokens" token env variable to true when using the default OpenAI configuration now that we're using 5.6 luna and this flag is required there (#3007).
  • We're migrating to a custom karakeep chrome container (based on https://github.com/chromedp/docker-headless-shell) now that the old alpine-chrome is no longer fetch-able (and has been long abandoned by the maintainer). Check the migration guide here. The old image will continue to work, but it's recommended that you migrate to the new one as it also upgrades chrome to 151 (compared to 124 in the old image). If you've been using browserless (e.g. on unraid), you're not impacted by this, and you don't need to migrate.
  • Large singlefile archives (typically because of videos) used to fail metadata extraction as the parser used to OOM. We strip inline videos now to make the parsing succeed.
  • Hardened the link to asset conversion mechanism in the crawler that used to result into silently broken assets. (#3002)
  • Pinned nodejs to version 24.18.1 thanks to @eriktews (#2996) to overcome a bug in the latest node 24.19 version (check #2989 for details). The proxmox scripts also were pinned by @MickLesk.
  • Karakeep's favicon is now light/dark mode aware, thanks to @ehfreema (#2990).

New features:

  • You can now upload custom SingleFile archives to karakeep directly using the CLI.

Changelog

Contributors

eriktews, MohamedBassem, and 2 other contributors
Assets 3
Loading

0.33.1

0.33.1

Choose a tag to compare

View all tags
@MohamedBassem MohamedBassem released this 01 Aug 21:10
Immutable release. Only release title and notes can be modified.
v0.33.1
aa69d1d

0.33.1

Welcome to the 0.33 release of Karakeep! The headline of this release is semantic search. Karakeep can now generate embeddings for your bookmarks, letting you search by meaning instead of exact keywords (and making auto-tagging noticeably more consistent along the way). The mobile app gets offline reading, so you can save articles to your device and read them on a plane, along with new layouts, sorting, and one-tap clipboard saving. Cookie and GDPR consents should be something of the past with this release (finally). Plus a big batch of crawler, security and performance fixes.

Thanks to everyone who contributed to this release: @esimkowitz, @joestump, @zerone0x, @ElectricTea, @optix2000, @thiswillbeyourgithub, @jcgoodwin86, @InventorB, @VrtxOmega, @pike00, @KayMi, @TanishValesha, @mahirhir, @moduvoice, @eviaaaaa, @archit-goyal, @CertStone, and everyone who shipped code, triaged bugs, or shared feedback.

Note: the changes mentioned here for the extension and mobile releases will need to go through the different store (apple, google, mozilla) reviews. So it might take a couple of days until all of them are released.

If you enjoy using Karakeep, consider supporting the project here ☕️ or via GitHub here. Also share Karakeep's managed offering (☁️ link) with your friends who're not into selfhosting.

Buy Me A Coffee

New Features 🚀

  • Semantic Search (#2959, #2960) - Search is no longer limited to exact keyword matching. There are now three search modes, switchable from a dropdown in the search bar:
    • Full text - the existing keyword search (still the default).
    • Semantic [Experimental] - pure meaning-based search powered by embeddings. Searching for "how to make coffee" will find your espresso bookmarks even if they never use those words.
    • Hybrid [Experimental] - fuses the results of both.
    • The new mode is also available in the API, MCP and CLI which is going to be the most useful with agents.
    • Semantic search is still new and experimental, so results might not be super accurate yet, but it's a start.
    • ⚠️ Semantic search requires embeddings to be enabled, read the upgrade notes for details about how to enable them.
  • Smarter auto-tagging using embeddings (#2858) - When tagging a new bookmark, Karakeep now looks up semantically similar bookmarks and feeds their existing tags into the LLM prompt as suggestions. The result is a lot less tag sprawl (no more k8s, kubernetes and Kubernetes all coexisting). This also requires embeddings to be enabled, read the upgrade notes for details about how them.
  • Cleaner saved pages (#2973): the crawler now detects common consent dialogs (cookies and GDPR) and automatically opts out before capturing the article, screenshot and PDF.
  • Offline reading on mobile (#2957) - The mobile app can now work without a connection:
    • Save articles for offline: from a bookmark's "…" menu, pick Make available offline. The full article is downloaded and kept on device until you remove it.
    • Recent cache: everything you browse (bookmark lists, tags, lists, highlights) is now persisted for 7 days, so recently visited screens still open when you're offline.
  • Mobile app improvements:
    • New layouts (#2837): switch between the existing card layout and a new compact list layout. Note: the default is now the list layout.
    • Sorting (#2777): sort your bookmarks newest-first or oldest-first (overdue, sorry!).
    • Save from clipboard (#2868): a new Clipboard entry in the "+" menu saves whatever is in your clipboard in one tap. Thanks @InventorB!
    • The manage bookmark sheet now has favourite, archive, share and highlights actions instead of just delete.
  • Karakeep for agentic usage - continuing where 0.32 left off:
    • MCP server went from 8 to 29 tools. Newly added: full list CRUD, full tag CRUD, highlights, delete-bookmark, and get-asset. Big thanks to @joestump for the list/tag CRUD work (#2917)!
    • New readable content API (#2660): GET /api/v1/bookmarks/{bookmarkId}/content returns a bookmark's article content as markdown or plain text, cursor-paginated in LLM-friendly chunks that snap to paragraph boundaries.
  • Much faster bookmark metadata (#2932): Karakeep's pre-flight http request to the website can now contribute to its metadata extraction. This results into some metadata (e.g. title) appearing much faster. A new CRAWLER_PREFLIGHT_USER_AGENT option lets you set a user agent for that probe request, and let's just say that a good user agent makes a huge difference.
  • The default OpenAI model has changed from gpt-4.1-mini to gpt-5.6-luna which is half as cheap, though a bit slower given that it's a reasoning model.

UX Improvements ✨

  • Re-saving an existing bookmark now actually does something (#2962) - Saving a link you've saved before used to just tell you "Bookmark already exists" and do nothing. Now it re-saves it: the bookmark is un-archived and bumped back to the top of your list.
  • Smarter bookmark previews (#2975) - Newly crawled pages are now assessed for how well they work in Reader View. Articles continue to open in the clean reader, while homepages, search results, product pages and other non-article content default to a screenshot or a new page-overview panel instead of showing a poor text extraction. You can still switch among the overview, Reader View, screenshot, PDF and archived page from the preview selector.
  • Bulk edit is now one hover away: instead of first switching bulk edit on from the toolbar, a selection circle appears directly on a bookmark card when you hover it. Selecting one card puts you into bulk edit mode for the rest.
  • The sidebar is now wider on large screens, and its scrollbar only appears when you hover it instead of sitting there permanently.
  • Mobile polish: a proper loading state while an article is still being crawled, better reader contrast in dark mode, a rebuilt login screen with much clearer connection errors, faster Manage Tags page on large libraries (server-side search instead of loading every tag), iPad/tablet reader toolbar and FAB fixes by @esimkowitz (#2788, #2793, #2794), and a bunch of redundant success toasts removed.
  • Karakeep is now installable as a PWA in Chrome again, allowing you to use karakeep on your desktop as if it's one of the apps.
  • New Instagram renderer (#2836): Instagram posts and reels now render as the actual embedded post in the bookmark preview, joining the existing YouTube, X, TikTok and Amazon renderers.

Fixes 🐛

  • Security fixes:
    • Fixed a DNS rebinding / TOCTOU hole in the crawler's SSRF protection (#2945). Reported by @celinke97 (GHSA-vc53-r298-c6h6).
    • API key and signed asset token verification now use timing-safe comparisons, reported by @xancyber (GHSA-hjm9-gc55-5hgv).
    • Bookmark URLs are now restricted to http/https on create and update. Reported by @therawdev and @shukla304 (GHSA-6mfw-xrw2-h5x3).
    • Legacy bookmarks with unsafe schemes are filtered out of RSS feeds and Netscape HTML exports, and the exported URLs are HTML-escaped. Reported by @karen93shieh and @MuxiLyuLucy (GHSA-4vx2-9j8p-jg8v).
    • Tag names are now HTML-escaped in Netscape bookmark exports, preventing a crafted or AI-generated tag from breaking out of the TAGS attribute when the export is opened in a browser.
    • User-supplied names (user names, list names, inviter names) are HTML-escaped in outgoing emails, fixing HTML injection in the list invitation email. Reported by @therawdev and @shukla304 (GHSA-pvj2-rgwm-r7f8).
    • Password logins are now rate limited (10 attempts per 15 minutes per IP + email). Note that this requires RATE_LIMITING_ENABLED=true.
    • Closed account-enumeration side channels in login and password reset.
  • Much faster bookmark deletion (#2669): added the missing indexes that should make deletions less IO intensive for large libraries.
  • Old completed import sessions are now archived after 30 days: their summary counts are kept, but the per-bookmark staging rows are deleted, which keeps the DB from growing unboundedly after big imports.
  • YouTube/video downloads work again - yt-dlp now uses the bundled node as its JS runtime, by @pike00 (#2805).
  • Fixed BROWSER_WEB_URL failing to resolve on IPv6-only Docker networks by @VrtxOmega (#2863).
  • Fixed the X/Twitter renderer, which broke after the API changed its response shape.
  • Inline images in SingleFile archives are no longer clobbered by the lazy-load normalization, by @zerone0x (#2928).
  • Banner/preview image extraction now works for SingleFile and precrawled archives that inline the image as a data URI.
  • Fixed summarization producing garbled output for users running with INFERENCE_OUTPUT_SCHEMA=json, by @eviaaaaa (#2926).
  • New OPENAI_TIMEOUT_SEC option to control the per-request inference timeout, useful for slow self-hosted providers, by @optix2000 (#2876).
  • Hardened the tagging prompt: tags are now capped to 1–3 words, and Karakeep explicitly returns no tags for error pages, Cloudflare/CAPTCHA interstitials, cookie banners and login walls - so no more just a moment or cloudflare tags on failed crawls.
  • Fixed the MCP get-bookmark-content tool crashing on bookmarks that haven't been crawled yet, by @joestump (#2915).
  • Fixed scrolling in the bookmark preview's screenshot view by @VrtxOmega (#2864).
  • The browser extension now requests host permissions at runtime for client-side crawling (#2784), instead of asking for them up front.
  • Added missing Japanese translations by @mahirhir (#2903) and filled in the missing Korean...
Read more

Contributors

joestump, optix2000, and 22 other contributors
Loading
8 Join discussion

0.32.0

0.32.0

Choose a tag to compare

View all tags
@MohamedBassem MohamedBassem released this 08 May 17:55
v0.32.0
b9b252e

Welcome to the 0.32.0 release of Karakeep! The mobile app is getting a major redesign by @esimkowitz so that it feels more native and friendly to use. Our long-overdue Safari extension is now available on the app store. Karakeep is now more AI-agents friendly with an official skill, revamped and more powerful CLI, granular API keys (and more coming in the next release). SingleFile is now integrated inside the karakeep extension itself for better crawling of authenticated pages. Keyboard shortcuts for faster actions across the app. And tons of fixes!

This release has a huge list of contributors. Some frequent faces, and many contributing their first PRs. Thanks @esimkowitz, @Mxrk, @beluga73, @Ahmed-Abdel-karim, @GSAlex, @cinconueves, @keslerm, @xingzihai, @howwohmm, @vbalko-claimate, @MaximePinot, @apo-mak, @NikhilChowdhury27, @maxim-mityutko, @xuatz, @ir31k0, @Joly0, @larsborn, @venku122, @lmgarret, @hoilc, @zerone0x, @mrInvincible29, @Go2Engle, @faximan.

Note: the changes mentioned here for the extension and mobile releases will need to go through the different store (apple, google, mozilla) reviews. So it might take a couple of days until all of them are released.

If you enjoy using Karakeep, consider supporting the project here ☕️ or via GitHub here. Also share Karakeep's managed offering (☁️ link) to your friends who're not into selfhosting. We're offering yearly subscriptions now.

Buy Me A Coffee

New Features 🚀

  • Karakeep's Safari extension is now available on the App Store (link), closing Karakeep's oldest open issue (#10).
  • Huge mobile app revamp lead by @esimkowitz:
    • More native screens, headers and action buttons by @esimkowitz (#2685)
    • Customizable reader toolbar by @esimkowitz (#2527)
    • Add ability to keep screen on for bookmark reading by @esimkowitz (#2691)
    • Opening links in the reader view now opens them in an in-app browser so that you can quickly go back to where you left by @esimkowitz (#2696)
    • Add ability to default open links in external browser by @xingzihai (#2516)
  • Karakeep for Agentic usage: Our goal is to make Karakeep very AI agents friendly. This will allow agents (OpenClaw, Hermes, etc) to find and hoard interesting content on your behalf, provide weekly digests, and more.
    • We're publishing an official skill for karakeep on ClawHub and skills.sh (details here). Those skills teach the agent karakeep's concepts and how to use the CLI.
    • CLI improvements:
      • The CLI also got major improvements allowing it to manage more aspects for bookmarks, lists, and tags. Also got more AI friendly formatting, etc.
      • To avoid having to pass the address and API key with every request, karakeep can now store the auth config in a file and use it for further requests. Init that file with karakeep auth init.
    • If you're afraid to give agents full Read/Write access to your data, API keys now have granular scopes to all resources. Which means you can give agents access to your bookmarks but not administrative actions (like deleting users), etc.
  • Keyboard Shortcuts: You can now do more with the keyboard, as we added support for navigating the bookmark grid with keyboard shortcuts, and taking actions such as favouring/archiving and doing bulk actions. This is the beginning, and please send feature requests for the extra features you need.
  • Extension improvements:
    • [Experimental] The extension can now crawl bookmarks from the client-side eliminating the need of using the SingleFile extension separately from Karakeep (Powered by SingleFile core). This allows you to store pages that are behind authentication or unreachable from your Karakeep server. It's currently opt-in until stable, and then will become the default. Enable it from the extension settings (#2197).
    • Added support for manual save (instead of the default save on open) by @keslerm (#2693)
  • More import sources:
  • Others:
    • Karakeep MCP now has an update-bookmark tool by @vbalko-claimate (#2717)
    • Add support for writing rule engine rules based on bookmark source by @xingzihai (#2547)
    • Add support for configuring OpenAI reasoning effort by @cinconueves (#2718)
    • New extensive event logging for events that happen all over the app. More info about how to enable it here.

UX Improvements ✨

  • Visual revamp for the bookmark preview page with nicer colors and ability to collapse the sidebar (f500129).
  • Visual revamp for the "All lists" page showing list privacy settings and number of items in each list (145dda9).
  • List and tags page headers now show more info about the content and type of the list/tag (#2749)
  • Quickly favourite and archive a bookmark by new buttons that appear on hover (98e173d).
  • Haptic feedback on mobile sidebar navigation (f91ec53).
  • Show "+" in the tag count badges when more pages exist by @zerone0x (432235b).
  • In the add bookmark to list dialog, you no longer need to explicitly save the selection thanks to @xingzihai (#2629)
  • The default new list emoji changed from "🚀" to "📁". Maturity, I guess?
  • You can now add multiple lists to the same rule engine condition by @Ahmed-Abdel-karim (#2620)
  • Timestamps across the app are now correctly localized instead of showing the server's timezone (#2682)

Fixes 🐛

  • Important Security fixes:
    • Reported by @tahirsercan (GHSA-g647-327m-79g9)
      • Fix SSRF validation bypass caused by redirects in crawler and video worker
    • Those issues were reported by Sami Zayn:
      • Add missing ratelimits for the changePassword endpoint
      • Sanitize user names before storing them to avoid stored XSS in karakeep emails (#2724)
      • Invalidate existing password reset tokens before issuing a new one (#2722)
    • Reported by @CE2Sec (GHSA-7rx4-c5vx-g8w3)
      • Fix blind SSRF in crawler favicon extraction
    • Add missing ratelimits for bookmark creation and asset upload APIs
  • Fix a bug where adding a bookmark to a tag or list didn't appear immediately requiring a refresh.
  • Bulk actions used to hammer the server with cache refill requests, those are now debounced.
  • Fix adblocker getting skipped due to the URL validation interception.
  • Fix "Manage tags" page on iOS not scrolling correctly.
  • Prevent highlight popup from stealing focus on Firefox (11dfe74)
  • Fix rare crash in the crawler worker (d197f59)
  • Increase max feed url length to 2k chars (07454a6)
  • Fix cropped text in android app when using bold text by @Go2Engle (#2554)
  • Fix occasional problems connecting to server from mobile app when it's behind a reverse proxy by @mrInvincible29 (#2559)
  • Better extraction for lazy loaded images from content by @zerone0x (#2556)
  • Expand $tags/$aiTags/$userTags in AI prompt preview by @zerone0x (#2557)
  • Fix sourceUrl not getting saved when creating asset bookmarks via the API by @hoilc (#2574)
  • Redact internal server error messages in prod responses (c8a75a0)
  • Correctly parse linkwarden collections during import (722fd8c)
  • Correctly extract TWZ RSS categories as tags by @venku122 (#2589)
  • Correctly skip tagging and summarization for assets that fail preprocessing to avoid misleading numbers in the admin panel
  • Improve meilisearch request batching for better performance
  • Enable configuring monolith timeout and arguments by @NikhilChowdhury27 (#2659)
  • Fix openai proxy setting not getting respected by the openai client (#2676)
  • Fix formality and tone for a bunch of languages to match that of English
  • Use the same proxy URL for all network interactions within the same crawler job run
  • Fix parsing archived status for bookmarks imported from Pocket by @howwohmm (#2656)
  • Fix parsing archived status and folder for Instapaper bookmarks
  • Upgrade playwright to 1.59 to fix browserless compatibility issues
  • Stricter full text search matching strategy for bookmarks to provide more relevant results (68e7350)
  • Fix unreachable background script on Firefox by @Joly0 (#2649)
  • Update default meilisearch version to 1.41 by @ir31k0 (#2643).
    • If you want to update your instance, check out meilisearch's guide here.
  • Fix truncate long bookmark titles on mobile app by @xuatz (#2699)
  • Dedupe crawl jobs using idempotency key by @NikhilChowdhury27 (#2678)
  • Add ability to finalize/delete a staged import session that might have been stuck before (#2713)
  • Fix low quality video downloads caused by missing ffmpeg dependency to yt-dlp by @MaximePinot (#2721)
  • Better ratelimiting for users behind the same IP (e.g. NAT) by including userId in the ratelimit key
  • Use relative path for logout redirect to avoid port mismatch by @howwohmm (#2655)
  • Skip URL type identification requests if a page is crawled with SingleFile by @GSAlex (#2580)
  • Fix text clipping in bookmark card notes by @beluga73 (#2748)
  • For CLI based server migrations, tags attachedBy is now correctly migrated (462d713)

For Developers 🛠️

  • The API docs now have much more extensive documentation. (dd2c6cc)
  • New APIs:
  • Map TOO_MANY_REQUESTS to 429 status code in the API instead of internal server error (5b6402f)
  • The docker-c...
Read more

Contributors

claude, GSAlex, and 29 other contributors
Loading
1 Join discussion

0.31.0

0.31.0

Choose a tag to compare

View all tags
@MohamedBassem MohamedBassem released this 22 Feb 11:49
v0.31.0
ba3db95

0.31.0

Welcome to the 0.31.0 release of Karakeep! This release brings synchronized reading progress, LLM-based OCR, a revamped import pipeline, drag-and-drop for lists, highlights on mobile, a lot of mobile polish, and fixes for some long standing bugs. Huge thanks to our contributors for this release @esimkowitz, @WieserDaniel, @chen-ye, @SnowSquire, @mokhovyk, @evan6seven, @ElectricTea, @RobertRosca, @sweepies, @usr3 and everyone who shipped code, triaged bugs, or shared feedback for this release.

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

Buy Me A Coffee

And in case you missed it, we now have a ☁️ managed offering ☁️ for those who don't want to self-host. You can signup here 🎉.

New Features 🚀

  • Synchronized reading progress across all your devices (#2302). By @esimkowitz!
    • Your reading position is now saved and synced, so you can pick up right where you left off on any device.
  • LLM-based OCR as an alternative to Tesseract (#2442)
    • You can now use your configured LLM for OCR instead of Tesseract, which produces significantly better results for image and asset bookmarks.
  • Revamped Import pipeline (#2378)
    • The import experience got another big overhaul: a new import details page (#2451), a dedicated low-priority queue for import crawling (#2452), better progress tracking, ability to pause an import and more resilient error handling.
  • Drag-and-drop bookmarks into lists (#2469)
  • Highlights support on mobile (#2494)
    • You can now view and create highlights in the mobile app's reader view.
  • AI tag suggestions: instructs the model to limit auto-tagging to a subset of your existing tags for more consistent results (#2444).
  • Export lists in backups and exports (#2484)
    • Automated backups and full exports now include your lists.
  • Others:
    • Retry buttons for dangling (aka pending) bookmarks in the admin panel (#2341).
    • Add signup support to the mobile app.
    • OpenAI service tier configuration via OPENAI_SERVICE_TIER (#2339). By @RobertRosca!
    • Import from Instapaper (#2434). By @WieserDaniel!
    • Privacy-respecting bookmark debugger admin tool (#2373)
    • MCP server now supports custom configurable HTTP headers (#2436). By @chen-ye!
    • New search qualifiers:
      • source: filter to search by bookmark source (mobile, extension, web, etc.) (#2465).
      • tag: alias for # and ! alias for negation (#2425).
      • New "Title Contains" condition in the Rule Engine (#2354). By @mokhovyk!

UX Improvements ✨

  • Mobile app overhaul:
    • Native tabs and more native-feeling screens.
    • Animated UI feedback in the sharing modal (#2427).
    • Show bookmark count in the all lists view.
  • Better looking content fetching loading state in the bookmark preview.
  • Two-phase metadata updates so bookmarks show up faster while crawling is still in progress (#2467).
  • Links to apps, extensions and docs in the profile dropdown.
  • Extension autofocuses on note field on open (#2366). By @SnowSquire!
  • Improving the visual consistency of the settings page.
  • Opt-in OAuth auto-redirect for single-provider passwordless setups (#2483)
  • Add a download button for assets in the bookmark options menu.
  • API keys now show their last-used dates to better identify unused keys.
  • Fix masonry overflow in bookmark grids (#2400). By @evan6seven!
  • Hide confusing No suggestions message when no search suggestions are available.

Fixes 🔧

  • [Security] Sanitize reddit's crawling output to prevent stored XSS. This was reported by @ByamB4 and published as a github advisory (GHSA-mg93-f9mw-wpgj).
  • Eliminated O(n²) parsing of Netscape bookmark imports (#2338).
  • Smart lists can now be used in search qualifiers and in other smart list queries (#2470)
  • Parallelize content extraction in the crawler worker for faster crawling.
  • Batch meilisearch indexing requests for better performance (#2441).
  • Auto dismiss dialogs during crawling that might have caused worker crashes before.
  • Use user's preferred language for manual summarization (#2429).
  • Accept more permissive RSS feed content types (#2353). By @ElectricTea!
  • Fix clipping of reader view in smaller screens.
  • Fix overscrolling in some setting pages (e.g. AI settings).
  • Stop theme flashes with Cloudflare Rocket Loader (#2340). By @sweepies!
  • Retry 403, 429 and 5XX status codes from the crawler.
  • Lower priority of recrawling and mass admin actions to avoid starving interactive traffic.
  • Fix scrolling in manage lists/edit tags when inside a dialog (#2258).
  • Respect archived display behavior setting in mobile lists and tags (#2499).
  • Fix flicker on closing bookmark preview on search page.
  • Share PDFs from the mobile app as files instead of links.
  • Fix high CPU usage of browser container after large imports due to leaking contexts. (#2503)
  • Reader settings preview in the mobile app now matches reader view formatting (#2365). By @esimkowitz!
  • When saving an image or a link from a page using "Add to Karakeep" menu item, the title of the original page is no longer incorrectly used for that link.

For Developers 🛠️

  • Docker images moved from Alpine to Debian.
  • OpenTelemetry instrumentation for database queries and extra tracing in OTEL traces (#2453).
  • Prometheus metric for bookmark crawl latency (#2461).
  • New checkUrl API endpoint to check if a URL is already bookmarked.
  • attachedBy field in the update tags API endpoint to mark the tag as added by human or AI (#2281).
  • Upgraded to Expo SDK 54, React 19.2.1, and Node.js 24.
  • CLI can now search bookmarks (#2426).

Screenshots 📸

Reader Progress

https://github.com/user-attachments/assets/86b259f6-2ce7-493f-a02c-d883c76c901c

Import Details

https://github.com/user-attachments/assets/b37c91a5-b74a-4de5-94d3-f25c346cae7b

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, bump the version and then run docker compose pull && docker compose up -d.

All Commits

Read more

Contributors

brandongalbraith, chen-ye, and 11 other contributors
Loading
3 Join discussion

0.30.0

0.30.0

Choose a tag to compare

View all tags
@MohamedBassem MohamedBassem released this 01 Jan 10:50
v0.30.0
d472a3a

0.30.0 (New year release 🎁)

Welcome to the 0.30.0 release of Karakeep and happy new year! This release comes with "2025 wrapped" (a bit late), PDF archives, new reader settings, avatars, reddit crawling improvements, and more! Huge thanks to our contributors for this release @esimkowitz, @Moondragon85, @rzxczxc, @colado, @Yeraze, @eriktews and everyone who shipped code, triaged bugs, or shared feedback for this release.

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

Buy Me A Coffee

And in case you missed it, we now have a ☁️ managed offering ☁️ for those who don't want to self-host. We're in public beta now and you can signup here 🎉.

New Features 🚀

  • 2025 Wrapped is here to celebrate your year in Karakeep (#2322).
  • PDF archives
    • Archive bookmarks as PDFs, generated automatically during crawling or on-demand (#2309).
    • Set CRAWLER_STORE_PDF=true to enable auto PDF archiving.
  • Unified reader settings (font, size, etc) across all devices with per-device overrides (#2230). By @esimkowitz!
  • Better metadata extraction:
    • Reddit posts should now be crawled correctly, and banners should be fetched more reliably.
    • Fixed YouTube thumbnail and author extraction.
    • Fixed Amazon product image extraction (where it was sometimes showing the prime logo) (#2204, #2108). By @Yeraze
  • Upload custom user avatars for more personal profiles (#2296).
  • AI Setting customization:
    • Customize tag styling (case, separators, language) per user. It's highly recommended to set the tag style for more consistent tags (#2312).
    • Per-user toggles to disable auto-tagging and/or auto-summarization (#2275).
  • Others:
    • Import libraries from Matter with full export support (#2245). By @Moondragon85
    • Bulk remove bookmarks from lists (#2279).
    • Add a new rule condition to rule engine: "URL Does Not Contain" (#2280).
    • Configure an OpenAI proxy via OPENAI_PROXY_URL (#2231). By @rzxczxc
    • Added is:broken search qualifier to show links that failed crawling (#2225).
    • Edit list now in the mobile app (#2310). By @colado

UX Improvements ✨

  • Our docs got a facelift! The docs got some styling, the pages got re-organized and we now have a "Using Karakeep" section that explains some of the core concepts of Karakeep.
  • Replace bookmark banners and download attachments directly from the drop down menu (#2328).
  • Sidebar scrollbar looks cleaner, and pending list invites show as a badge in the sidebar.
  • Bookmark edit dialog now includes notes.
  • Bookmark owner avatars now show up in collaborative lists.
  • Mobile UI/UX improvements:
    • Fixed title on mobile to be at most 2 lines long.
    • Mobile settings screens should now feel more native (#2307).
    • OLED-friendly colors in the Android app matching the colors of the ios app (#1958).
    • Toasts on iOS now appear correctly above the open modals (#2320). By @colado
    • Shared lists now appear in a dedicated subsection on mobile.
    • Adding a bookmark to a list now shows a spinner during loading (#2283).
    • Server version now appears in mobile settings (#2276).
    • Fixed the confusing "tick button" beside the server address during login.

Fixes 🔧

  • Fixed missing db indicies that was causing slow bookmark queries (#2246, #2287).
  • Improved Ollama summaries by using the generate endpoint (#2324). By @eriktews
  • Fixed HTML bookmark imports failing on empty folder names (#2300).
  • Fixed non-link bookmarks stuck in pending summarization (#1605).
  • Improved tagging prompts and error-page detection.
  • Reject spoofed content types on file uploads.
  • Preserve failure counts when rescheduling rate-limited domains (#2303).
  • Fixed duplicate backdrop buttons in reader view (#2234). By @colado
  • RSS feed fetching is now spread over the hour (#2227).
  • Asset preprocessing worker timeout is now configurable (91784cd).
  • Fixed bypassing email verification in apiKey.exchange.
  • Added limits on number of rss feeds and webhooks per user configurable by admins.
  • Fixed a bug where failed crawling leave bookmarks as pending tagging in the admin dashboard.

For Developers 🛠️

  • OpenTelemetry integration with OTLP exporter (#2318, #2321).
  • CLI can list users for admins.
  • We're now defaulting to Node.js 24 (the current LTS).
  • Breaking: In bookmark APIs includeContent now defaults to false. This change was announced a couple months ago, and is taking effect in this release.

Community Projects 💡

Screenshots 📸

Wrapped 2025

karakeep-wrapped-2025

Reader Settings

https://github.com/user-attachments/assets/4d81cb80-f9b8-43f2-998a-736f18e33038.

AI Settings

https://github.com/user-attachments/assets/48032bf6-5413-44ee-9c3b-ac7b385aeccf

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, bump the version and then run docker compose pull && docker compose up -d.

All Commits

Read more

Contributors

claude, eriktews, and 7 other contributors
Loading
0 Join discussion

0.29.3

0.29.3

Choose a tag to compare

View all tags
@MohamedBassem MohamedBassem released this 12 Dec 09:14
v0.29.3
9cbf402

Well. Upgrading Nextjs one more time to patch CVE-2025-67779.

Loading

0.29.2

0.29.2

Choose a tag to compare

View all tags
@MohamedBassem MohamedBassem released this 11 Dec 23:12
v0.29.2
648a4f7

Upgrading Nextjs to patch two new vulnerabilities in react CVE-2025-55184 & CVE-2025-55183. This is on top of the critical vulnerability (CVE-2025-66478) that was patched in 0.29.1.

Loading

0.29.1

0.29.1

Choose a tag to compare

View all tags
@MohamedBassem MohamedBassem released this 03 Dec 16:56
v0.29.1
fc0f6b1

0.29.1

A patch release for 0.29.0 with the fix of NextJs CVE: CVE-2025-66478

Loading

0.29.0

0.29.0

Choose a tag to compare

View all tags
@MohamedBassem MohamedBassem released this 29 Nov 18:26
v0.29.0
f01d96f

0.29.0

Welcome to the 0.29.0 release of Karakeep! This release ships some of our most awaited features. Collaborative lists, automated bookmark backups, search auto complete, highlighs are getting notes and search, and the mobile app is getting some more love. As usual thanks to @aa-ko, @fivestones, and everyone who shipped code, triaged bugs, or shared feedback for this release.

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

Buy Me A Coffee

And in case you missed it, we now have a ☁️ managed offering ☁️ for those who don't want to self-host. We're still in private beta (you can signup for access here) and gradually letting more and more users in. We're in public beta now and you can signup here 🎉.

New Features 🚀

  • Collaborative lists are here! (#2146, #2152)
    • You can now invite collaborators to your lists and manage their access levels between viewers and editors.
    • This was the most requested feature on the roadmap, and it's now here!
  • Automated bookmark backups you can schedule once and forget (#2182)
    • Currently it only captures non-asset bookmarks, but I'm planning to include lists, tags, and other metadata in the future.
  • Search gets autocomplete so you can find the right filters and terms faster (#2178)
  • Highlights overhaul: notes + search bar on web, plus a dedicated highlights page on mobile (#2154, #2155, #2156, #2157)
  • Mobile catches up with smart list creation and an all-tags screen (#2153, #2163)
  • Crawler domain rate limiting to avoid getting throttled by external sites (#2115)
    • Configure it with CRAWLER_DOMAIN_RATE_LIMIT_WINDOW_MS and CRAWLER_DOMAIN_RATE_LIMIT_MAX_REQUESTS.
  • Import from MyMind (#2138)

UX Improvements ✨

  • Sidebar typography and colors should feel nicer (specially in dark mode).
  • Page titles are now correctly displayed in the browser tabs.
  • We have a friendlier 404 page for bookmarks/lists that don't exist.
  • You can now see stats about the source of your bookmarks in the usage stats page (extension, web app, mobile app, etc).

Fixes 🔧

  • Prompts lazily load js-tiktoken which should cut between 70-150MB of karakeep's memory usage (#2176)
  • The edit dialog wasn't correctly showing the extracted text from assets, this is now fixed (#2181).
  • IP validation allowlisting now allows bypassing all domains by setting CRAWLER_ALLOWED_INTERNAL_HOSTNAMES to ..
  • Fix a worker crash when hitting invalid URLs with proxy enabled.

For Developers 🛠️

  • GET /api/version endpoint for getting server version (#2167)
  • More visibility: HTTP status Prometheus counters, failed_permanent worker metric, and system metrics on web/worker containers (#2117, #2107)
  • Documentation updates for LOG_LEVEL and Raycast links (#2166, #1923) by @aa-ko and @fivestones

Screenshots 📸

Collaborative Lists

Screenshot 2025-11-29 at 6  23 18@2x

Automated Backups

Screenshot 2025-11-29 at 6  23 57@2x

Search Autocomplete

Screenshot 2025-11-29 at 6  24 54@2x

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, bump the version and then run docker compose pull && docker compose up -d.

All Commits

Contributors

fivestones, MohamedBassem, and 2 other contributors
Loading
2 Join discussion

0.28.0

0.28.0

Choose a tag to compare

View all tags
@MohamedBassem MohamedBassem released this 08 Nov 21:26
v0.28.0
4f025f5

0.28.0 (20k stars ⭐)

Welcome to the 0.28.0 release of Karakeep! We've have hit 20k stars on Github 🎉 (well 21k because I was too late with the release)! Thanks a lot for your support throughout this journey! This release brings a refreshed import pipeline, uploading custom attachments, revamped tags page, inline checklists, and a bunch of quality-of-life touches across the web app, extension and mobile app. Huge thanks to @BOTkirial, @qixing-jk, @@maya-doshi, @BenjaminMichaelis, @cloudchristoph, @claytono, as usual @xuatz and everyone who shipped code, triaged bugs, or shared feedback for this release.

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

Buy Me A Coffee

And in case you missed it, we now have a ☁️ managed offering ☁️ for those who don't want to self-host. We're still in private beta (you can signup for access here) and gradually letting more and more users in.

New Features 🚀

  • Revamped import experience with progress tracking (#2001)
  • Revamped Tags page that adds search and pagination to better serve users with thousands of tags (#1987)
  • You can now upload custom attachments to bookmarks (#2100)
  • When deleting a list, you can now optionally delete all its children (#1989)
  • Server overview highlights service dependency health.
  • Inline checklist toggling for text bookmarks (#1933) – @BOTkirial
  • With every release, you'll be prompted to view what's new in that release from inside the app.
  • You can now pass custom headers from the mobile app to the server (#2103)
  • Extension improvements:
    • Tab bookmark badge indicator by @qixing-jk shows when a page is already bookmarked (#1745)
    • You can now write notes directly after saving a bookmark in the extension (#2104)

UX Improvements ✨

  • Grid view controls expose title/tag toggles and image fit options (#1960)
  • Bookmark cards can surface saved notes across web and mobile (#2083) – @xuatz
  • Manage Lists modal is searchable for faster sorting (#2029)
  • The tags page now has a "Create Tag" button (#1942)
  • You can now regenerate the API key without having to recreate it.
  • New title: seach qualifier for searching bookmarks by title (#1940)

Fixes 🔧

  • ⚠️ (Potentially breaking change) ⚠️ Stricter URL valdaition to protect against SSRF attacks (#2082)
    • Webhook requests now go through the proxy if there's one configured
    • All server-initiated requests (including webhooks) to internal IP addresses are now blocked by default unless explicitly allowed via CRAWLER_ALLOWED_INTERNAL_HOSTNAMES. If your webhooks are hitting internal services, you'll have to allowlist them via CRAWLER_ALLOWED_INTERNAL_HOSTNAMES.
    • Monolith now honors the configured crawler proxy.
    • Metascraper logo extraction now respects the crawler proxy.
  • Crawler memory footprint shrinks with targeted optimizations (#1748)
  • Allow karakeep to use newer openai models that was previously failing because of deprecated max_tokens (#2000) - @BenjaminMichaelis
    • You'll need to set INFERENCE_USE_MAX_COMPLETION_TOKENS=true in your .env file to use the new models. This is eventually going to become the default.
  • Admin maintenance jobs respect abort signals to stop gracefully
  • Search input no longer crashes on percent signs and also works correctly with IME composition
  • Fixed a crash when sharing a list publicly that didn't have any bookmarks (#1990)
  • Screenshots are now stored as jpegs instead of pngs to reduce file size
  • Fixed a bug that was preventing tag merging (#1938)
  • RSS imports can apply feed categories as tags (#2031)

For Developers 🛠️

  • Create bookmark API returns 200 instead of 201 when a bookmark already exists
  • CLI Improvements:
    • New commands to migrate data from one server to another
    • New command to dump a full account archive
    • A new wipe command to selectively clean up data from the account

Community Projects 💡

Karakeeper

3rd Party iOS/Safari Client - by @simplytoast1

Karakeeper now is providing an alternative iOS native mobile/desktop client for Karakeep beyond its existing functionality of providing a safari extension.

Karakeep Sync

A syncing tool for Karakeep - by @sidoshi

A rust-based syncing tool that syncs: Hacker News upvotes, Reddit saved posts, Github stars and Pinboard bookmarks automatically to Karakeep!

Screenshots 📸

Inline Checklists

Screenshot 2025-11-08 at 8  55 18@2x

Import Sessions

Screenshot 2025-11-08 at 8  58 21@2x

Service Health Indicators

Screenshot 2025-11-08 at 8  56 00@2x

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, bump the version and then run docker compose pull && docker compose up -d.

All Commits

Read more

Contributors

claytono, abel, and 11 other contributors
Loading
2 Join discussion