Skip to content

Releases: karakeep-app/karakeep

0.29.1

03 Dec 16:56
@MohamedBassem MohamedBassem
v0.29.1
fc0f6b1

Choose a tag to compare

View all tags
0.29.1 Latest
Latest

0.29.1

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

Assets 2
Loading

0.29.0

29 Nov 18:26
@MohamedBassem MohamedBassem
v0.29.0
f01d96f

Choose a tag to compare

View all tags
0.29.0

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

08 Nov 21:26
@MohamedBassem MohamedBassem
v0.28.0
4f025f5

Choose a tag to compare

View all tags
0.28.0

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

0.27.1

13 Sep 19:56
@MohamedBassem MohamedBassem
v0.27.1
3bae3aa

Choose a tag to compare

View all tags
0.27.1

This is a hotfix release for 0.27.0.

🐞 Fixes

Contributors

halkeye and MohamedBassem
Loading

0.27.0

07 Sep 17:35
@MohamedBassem MohamedBassem
v0.27.0
d06c85d

Choose a tag to compare

View all tags
0.27.0

0.27.0

Welcome to the 0.27.0 release of Karakeep! This release brings website-aware previews, cookies support, redesigned background jobs page, and a lot of fixes and cleanups that accumulated over the past 1.5 months. Huge thanks to our contributors in this release:
@Ahmed-Abdel-karim, @qixing-jk, @youenchene, @Drashi, @thiswillbeyourgithub, @xuatz, @haappi, @CrazyWolf13, @landonepps, @dvdpearson, @vivienbcr, @yinan-c, @packetmonkey, @liCells and
everyone who reported issues and tested changes!

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

Buy Me A Coffee

And in case you missed it from the last release, 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 🚀

  • [Experimental] Karakeep now detects specific websites and renders a customized cards for them. We're starting with 4 special renders (and are accepting contributions for more):
    • X (twitter): Now shows a tweet embed by default.
    • Amazon: A card that shows the product.
    • Youtube: Renders a youtube embed (i.e. a player) by default.
    • Tiktok: Renders a tiktok embed (i.e. a player) by default.
    • If you want to see more websites supported, don't hesitate to send PRs. This is meant to evolve into karakeep understanding the different bookmark types (e.g. products, articles, etc) and showing more specialized cards for each type.
  • Background Jobs page got a complete redesign to better explain the different jobs (#1551)
  • Cookie support for crawling login-protected sites (#1664 by @liCells)
    • You can now pass a list of cookies for karakeep to use while crawling to access session-protected websites. Checkout the documentation of BROWSER_COOKIE_PATH here.
    • Note: This is an advanced feature. Cookies are extremely sensitive. Make sure you're handling them carefully. Also note that the cookies that you set are going to be shared with all the users in your instance. SingleFile remains the recommended way for accessing login-protected websites.
  • GIF asset support (#1876 by @Drashi)
  • Updated default chrome container to v124, make sure to update yours as well.

UX Improvements ✨

  • Browser Extension:
    • Theme selection and theme-adapting icon support (#1894 by @qixing-jk)
    • Constrain height of list and tag selectors to prevent viewport overflow (#1895 by @qixing-jk)
    • Both will come in the next extension release (aka soon).
  • Mobile:
    • Various mobile theme fixes (#1872)
    • Edit menu item on bookmark card
    • Add context aware sharing button in mobile app (#1785 by @xuatz)
    • Delete button and creation dates on info page
  • Render author, publisher, and publish date in bookmark view
  • Configurable number of grid columns in the bookmark grid (#1713)
  • Show loading indicator while the karakeep export is being generated (#1787/#1870 by @Ahmed-Abdel-karim)
  • Hide AI settings tab if inference isn’t configured (#1781)
  • Render human tags before AI tags (#1740 by @haappi)
  • Preserve selected bookmark preview section in link preview via query params
  • Hide bookmark actions from the navbar when no bookmark grid is shown
  • Dark mode titles fixed for public lists
  • Render AI summary in Markdown (#1869 by @youenchene)
  • Bookmark skeleton while search results are loading

Fixes 🔧

  • [Security] CSP policies on asset-serving paths
    • Fixes potential self-XSS on user uploaded assets.
    • Check the security advisory here.
    • Special thanks to @Skelmis for the disclosure!
  • Speed improvements:
    • Avoid prefetching assets and tags which should make the tags page loading smoother
    • Fixed a big (accidental) performance bottleneck in the API endpoints caused by API key validation. Re-login in your mobile app (and regenerate your API keys if you use any) for a significantly noticeable speed improvement.
  • Queue DB respects configured WAL mode
    • This fixes issues of slow imports and frequent locked databases
    • Enabling WAL is highly advisable
  • fix search query getting rest when bookmark preview is closed
  • Handle lists with slashes during imports and truncate long list names for more resilient imports
  • Don’t mark inference job as failed when content is missing (#1666)
  • fix WebView deceleration rate on iOS (#1835 by @landonepps)
  • Fix PDF detection when Content-Type includes charset (#1677)
  • Rule engine: deleting an action now doesn't auto-save (#1858)
  • Fix feed worker to use proxy when it's configured
  • Web UI will poll for longer (incrementally) as bookmarks are being fetched.
  • Fixed an issue with using SingleFile with S3 caused by unaccepted chars in filenames (#1765)
  • fix admin API route to be under /v1
  • fixed assets incorrectly marked as pending summarization
  • Add max output tokens env variable to control the max allowed number of tokens returned by the LLM (to control the costs).

For Developers 🛠️

  • Prometheus:
    • Workers now also export prometheus metrics. You need to enable the metrics endpoint and the port to crawl them.
    • Trpc latency was switched to histograms
    • karakeep_ prefix was added to all exported metrics (by @CrazyWolf13), you'll need to update your dashboards.
  • Enable/disable specific workers via env variables
  • You can now upload video attachments to bookmarks from the API (#1847 by @packetmonkey)

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.

Also upgrade your chrome container to 124 if you have it pinned.

All Commits

Read more

Contributors

packetmonkey, landonepps, and 15 other contributors
Loading

0.26.0

20 Jul 13:22
@MohamedBassem MohamedBassem
v0.26.0
fe501cf

Choose a tag to compare

View all tags
0.26.0

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.

Buy Me A Coffee

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 🛠️

Community Projects 💡

Karakeeper

3rd Party Safari Extension - by @simplytoast1

Screenshot 2025-07-20 at 2  16 48@2x

Karakeep Homedash

by @CodeJawn

image

Screenshots 📸

Usage Stats

image

The new Sign In page

Screenshot 2025-07-20 at 1  58 50@2x

Recent Searches

Screenshot 2025-07-20 at 1  59 55@2x

Reader Mode

Screenshot 2025-07-20 at 2  04 29@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, 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

Read more

Contributors

maelp, alexjsp, and 19 other contributors
Loading
2 Join discussion

0.25.0

08 Jun 09:57
@MohamedBassem MohamedBassem
v0.25.0
5b52066

Choose a tag to compare

View all tags
0.25.0

0.25.0

Welcome to the 0.25.0 release of Karakeep! This release addresses a lot of the top most upvoted feature requests. You can now share lists publicly, generate RSS feeds from your lists, reader view & pdf support in the mobile app, bi-directional browser bookmark sync using floccus, maintaining list structure on imports and a lot more. As usual, we have a lot of contributors in this release: @xuatz, @digithree, @thiswillbeyourgithub, @codelove77, @SConaway, @vhsdream, @AdrianAcala, @spasche, @SalGnt, @haappi, @yuikisaito, @jk, @jakeasmith, @Mxrk, @WilliamAGH, and @SteffoSpieler!

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

Buy Me A Coffee

New Features 🚀

  • Public Lists are here: You can now share your curated lists publicly! (#1511). Example list here.
  • RSS Feed Generation: Create and share RSS feeds directly for your lists (#1507)
  • Overdue Mobile Improvements:
    • Added reader mode/screenshot/archive views to bookmark previews on mobile (pending app release) (#1509) - @digithree
    • View PDFs directly in the mobile app and share them to karakeep from the share sheet as well (#1519, #1494) - @codelove77
  • Import / Export improvements:
    • Added NETSCAPE file export format support (#1374) - @yuikisaito
    • When importing netscape style bookmarks into karakeep, your lists will be re-created on karakeep. Preserving lists from other sources is planned.
    • Preserve archived status when importing from omnivore or pocket (RIP).
  • AI Auto-Summarization: Automatic summarization for new bookmarks can be now be enabled with INFERENCE_ENABLE_AUTO_SUMMARIZATION=true (#1163)
  • Floccus Integration: Karakeep now supports bi-directional sync with browser bookmarks using Floccus. This will be available in the next Floccus release within a week or two.

UX Improvements ✨

  • The user setting page got fully redesigned to look nicer given that we're starting to have more user settings.
  • Tab-based layout for bookmark previews on small screens - @thiswillbeyourgithub
  • Save pages faster with a dedicated extension shortcut (#1532) - @SConaway
  • Configure the default behavior when clicking on a bookmark. Either go to source, or expand the details.
  • Restored ability to properly sort by creation date for search pages (#1392) - @xuatz
  • You can now decide what you want to do when using the singlefile extension on an existing bookmark. Check out how to customize it here.
  • Configure whether you want to see archived bookmarks in lists or tags or not (#1505) - @xuatz
  • Added Algolia-based search to docs
  • Added "deleted" webhook event (#1464) - @SalGnt
  • The Summarize with AI button no longer shows up if you don't have AI configured
  • You can now disable auto AI tagging if not needed
  • Allow enabling/disabling RSS feeds collection
  • Added US English to folks who can't stand the British English - @WilliamAGH
  • Improved the positioning of the highlights menu on mobile devices - @Mxrk
  • Moved delete button in bookmark menu in the app for better ergonomics

Fixes 🐛

  • Started using proper tokenizer for content truncation before inference. This should prevent the truncation of the model prompt leading to better accuracy and instruction adherence.
  • Preserve unsaved changes during tag modifications while editing bookmarks (#1515) - @AdrianAcala
  • Fixed tag drag-and-drop issues on Firefox (#1016) - @haappi
  • Added log rotation for linux installations (#1471) - @vhsdream
  • You can now run Karakeep container as a non-root user for better security.

For Developers 🛠️

  • Added ?sortOrder parameter for resource sorting (#1398) - @xuatz
  • New endpoint for tag creation
  • PUT operations for bookmarks are now idempotent (e.g. adding to list) (#1427) - @xuatz
  • Added PATCH method support to CORS headers (#1489) - @spasche
  • Documentation:

Community Projects 💡

Screenshots 📸

The Share List Modal

Screenshot 2025-06-08 at 10 35 45@2x

Tabbed Layout on smaller screens

Screenshot 2025-06-08 at 10 37 11@2x

Reader Mode in the app

simulator_screenshot_1322546F-62F2-4129-89F7-7D77366179B6

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.

All Commits

Read more

Contributors

jk, spasche, and 15 other contributors
Loading
0 Join discussion

0.24.1

28 Apr 08:21
@MohamedBassem MohamedBassem
v0.24.1
5912277

Choose a tag to compare

View all tags
0.24.1

This is a hotfix release for 0.24.0.

🐞 Fixes

  • Reverts the smart list expansion in list: and is:inlist qualifiers as it can cause Karakeep's server to OOM (#1321).
  • Adds missing translations for the new features released in 0.24.0.
Loading

0.24.0

27 Apr 18:55
@MohamedBassem MohamedBassem
v0.24.0
6178736

Choose a tag to compare

View all tags
0.24.0

0.24.0 – Riding the MCP hype

Welcome to the 0.24.0 release of Karakeep! This release packs a ton of new stuff (we're back to shipping folks!). This release introduces a new MCP server for interacting with Karakeep through LLMs, a new rule generic rule engine for more control over organizing your bookmarks, new search qualifiers for feeds and bookmark age, overdue edit dialog for bookmark details, some UI polishing and more! This release also welcomes a TON of new contributors, @brandonw3612, @yorch, @Summon528, @dotvhs, @YTKme, @hasansino, @gomnitrix, @adripo, @meysam81, @SteffoSpieler, @jkywalker (And I probably missed some).

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

New Features 🚀

✨ MCP Server ✨

Unless you've been living under a rock recently, you've heard about the recent explosion of MCP servers all over the internet.
We're not going to miss the hype. This release ships a new MCP server (docs) that allows you to interact with your Karakeep instance and bookmarks through extrenal LLMs.
You can ask the LLM to summarize your bookmarks, search the web and send what it finds to Karakeep, or archive your recent chat as a text note in karakeep.
It can create new lists, attach tags and more to help you organize your bookmarks.

CleanShot 2025-04-27 at 7  39 35@2x

More demos in the screenshot section.

Generic Rule Engine ⚙️

Karakeep was born because I don't want to spend time organizing what I hoard. I just throw stuff in there and karakeep's tagging and search will help me retrieve it later.
However, turns out that not everyone is in the same camp. If you're one of those people who enjoy organizing their bookmarks, this feature is for you.
This release introduces a new generic rule engine that allows you to define arbitrary processing rules for organizing your bookmarks.

Some examples:

  1. If a bookmark is added, and it's coming from youtube, tag it with "#youtube" and "#video".
  2. If a bookmark is favourited, download an offline archive for it.
  3. If the tag "#fashion" is added to a bookmark, and this bookmark is an image, then add it my "Inspiration" list (You're better off using a smart list for this though).

CleanShot 2025-04-27 at 7  35 55@2x

⚠️ The firefox extension is back under a new name (Action Required) ⚠️

After the rebranding unfortunatly we couldn't get the old Firefox extension back, so we had to publish a new one (link).
If you're using the old "firefox" extension, you MUST migrate to the new one manually otherwise you won't be getting future updates.

And more!

  • gpt-4.1-mini is the new default text model: The default OpenAI text model changed to the new 4.1-mini. It's slightly more expensive than 4o-mini, but is supposed to be much smarter. The image model remains as 4o-mini as 4.1-mini is more expensive for images.
  • New Search & Smart list Qualifiers:
    • New “age:” search qualifier to show bookmarks older or newer than a given duration (by @brandonw3612).
    • New "feed:" search qualifier to find bookmarks imported from certain RSS feeds.
    • You can find the full query language here.
  • Edit Bookmark Details: You can now edit almost all the details of bookmarks. The URL, summary, creation date, everything. This is obviously very overdue.
  • List Merging: You can now merge lists together thanks to @gomnitrix.
  • Import Tab Session Manager Sessions: Bulk-import your Chrome/Firefox Tab Session Manager session files as Karakeep bookmarks by @yorch.
  • Configuring other AI providers: We added documentations for how to configure other AI providers beside OpenAI (link). This includes providers like Google AI Studio, OpenRouter, Perplexity, etc.
  • Karakeep on TrueNAS: People using TrueNAS can now find Karakeep in TrueNAS' app store thanks to @stavros-k.

UX Improvements ✨

  • Some UI polish
    – Reduced shadows, lighter font weights, smaller editor box following the suggestions of @dotvhs in #1261!
    – Removed focus rings where they don't matter much, fix popovers to the emoji picker (by @Mxrk), and list items in the sidebar now get truncated if they're long.
    – Fixed margins of the “New List” button, and fixed spinner visibility during AI summarization
  • Cached content is now called “Reader Mode” content.
  • There's now a nice looking "No bookmarks" banner for search and empty smart lists.
  • Lists now can have a short description beside their name (by @ekambains).
  • A new monochrome icon for android builds by @SteffoSpieler.
  • Copy link button now gets greyed out when on a non-secure context by @ekambains.
  • The github link in the sidebar now works correctly for people on the nightly build thanks to @hasansino.

For Developers 🛠️

  • Added includeContent to the API endpoints that return bookmarks (Listing, search, etc) to control whether the endpoint should include the content of the bookmark (which can be huge or not).
    • ⚠️ For backward compatibility, this defaults to true, but starting from the next release, this will default to false. So if your tool relies on the content of the bookmarks, start passing this to true now.
  • The API docs have a new look. The new look also fixes the enum-like requests types (like the one in createBookmark).

Fixes 🐛

  • Smart lists in search: Smart lists are now correctly resolved in the search qualifiers list: and is:inlist.
  • A much faster homepage loading times: If you've been a user for the SingleFile extension, Karakeep's homepage might have started getting slower recently. The UI was accidently downloading a big chunk of the archive in the homepage when it's not needed. This is now fixed.
  • Faster Imports: Importing bookmarks used to be extremely slow, now it's done with much higher parallelism and should be significantly faster.
  • Dark-mode icons for the firefox extension @L-K-M
  • Fixed the list getting opened when editing it from the sidebar.
  • Added a new INFERENCE_OUTPUT_SCHEMA configuration to restore support for models that only works with JSON mode (instead of the newer structured output mode).
  • Passwords stored in the database are now salted. For backward compatibility, existing users will continue using an empty salt until they change their password.
  • Karakeep now closes the browser after it's done crawling in "on demand" mode by @Summon528.
  • Fixed a bug in content extraction that might result in a suboptimal "cached content" being shown.
  • Triggering a search re-index now drops all the documents first to avoid dangling documents.

Community Projects 💡

Github 2 Karakeep Importer

By @hasansino

Exports your github stars automatically to Karakeep! Get it here.

Screenshots 📸

MCP Demo

CleanShot 2025-04-27 at 6  57 47
CleanShot 2025-04-27 at 6  59 25
CleanShot 2025-04-27 at 7  08 38

The new "No Bookmarks banner"

CleanShot 2025-04-27 at 7  41 54@2x

Bookmark Editing Dialog

CleanShot 2025-04-27 at 7  42 52@2x

Upgrading 📦

If you’re using KARAKEEP_VERSION=release:

docker compose pull && docker compose up -d

If you pin to a specific version, update KARAKEEP_VERSION, then:

docker compose pull && docker compose up -d

All Commits

Read more

Contributors

yorch, dotvhs, and 16 other contributors
Loading
8 Join discussion