Skip to main content
Version: v0.35.0

Troubleshooting

SqliteError: no such table: user​

This usually means that there's something wrong with the database setup (more concretely, it means that the database is not initialized). This can be caused by multiple problems:

  1. Wiped DATA_DIR: Your DATA_DIR got wiped (or the backing storage dir changed). If you did this intentionally, restart the container so that it can re-initalize the database.
  2. Missing DATA_DIR: You're not using the default docker compose file, and you forgot to configure the DATA_DIR env var. This will result into the database getting set up in a different directory than the one used by the service.

Chrome Failed to Read DnsConfig​

If you see this error in the logs of the chrome container, it's a benign error and you can safely ignore it. Whatever problems you're having, is unrelated to this error.

AI Tagging not working (when using OpenAI)​

Check the logs of the container and this will usually tell you what's wrong. Common problems are:

  1. Typo in the env variable OPENAI_API_KEY name resulting into logs saying something like "skipping inference as it's not configured".
  2. You forgot to call docker compose up after configuring open ai.
  3. OpenAI requires pre-charging the account with credits before using it, otherwise you'll get an error like "insufficient funds".

AI Tagging not working (when using Ollama)​

Check the logs of the container and this will usually tell you what's wrong. Common problems are:

  1. Typo in the env variable OLLAMA_BASE_URL name resulting into logs saying something like "skipping inference as it's not configured".
  2. You forgot to call docker compose up after configuring ollama.
  3. You didn't change the INFERENCE_TEXT_MODEL env variable, resulting into karakeep attempting to use gpt models with ollama which won't work.
  4. Ollama server is not reachable by the karakeep container. This can be caused by:
    1. Ollama server being in a different docker network than the karakeep container.
    2. You're using localhost as the OLLAMA_BASE_URL instead of the actual address of the ollama server. localhost points to the container itself, not the docker host. Check this stackoverflow answer to find how to correctly point to the docker host address instead.

Crawling not working​

Check the logs of the container and this will usually tell you what's wrong. Common problems are:

  1. You changed the name of the chrome container but didn't change the BROWSER_WEB_URL env variable.

Browserless compatibility​

Connections to Browserless through BROWSER_WEBSOCKET_URL use the Playwright protocol. The server must support the same Playwright major/minor version as Karakeep's bundled client.

Karakeep 0.34.0 bundles Patchright 1.59.4 (a Playwright fork), but Browserless v2.57.1 no longer includes a Playwright 1.59 server. As reported in #3207, this mismatch can leave every crawl stuck after Successfully navigated to "…". Waiting for the page to load ... until CRAWLER_JOB_TIMEOUT_SEC expires (60 seconds by default), even though the browser connection succeeds. The reporter's working comparison was Browserless v2.57.0, which still includes Playwright 1.59 support.

Prefer migrating to the Karakeep Chrome image. Set BROWSER_WEB_URL=http://chrome:9222 (adjust the hostname for your setup) and remove BROWSER_WEBSOCKET_URL. If you continue using Browserless, choose a release that supports your Karakeep client's Playwright major/minor version.

Upgrading Meilisearch - Migrating the Meilisearch db version​

Meilisearch is the database used by karakeep for searching in your bookmarks. Karakeep is tested with the Meilisearch version pinned in the bundled docker compose file, so prefer that version unless you have a reason to change it. After changing the Meilisearch version, you might see errors like Your database version (x.x.x) is incompatible with your current engine version (x.x.x).

See Upgrading Meilisearch for how to migrate the database in place, or how to rebuild it from Karakeep instead.