A self-hostable bookmark-everything app (links, notes and images) with AI-based automatic tagging and full text search
docs: update the docs for 0.33.2
Mohamed Bassem0d86b32c6692
diff --git a/docs/versioned_docs/version-v0.33.0/03-configuration/01-environment-variables.md b/docs/versioned_docs/version-v0.33.0/03-configuration/01-environment-variables.mdindex f1c9a704..fa83364c 100644--- a/docs/versioned_docs/version-v0.33.0/03-configuration/01-environment-variables.md+++ b/docs/versioned_docs/version-v0.33.0/03-configuration/01-environment-variables.md@@ -103,7 +103,7 @@ Either `OPENAI_API_KEY` or `OLLAMA_BASE_URL` need to be set for automatic taggin| OLLAMA_BASE_URL | No | Not set | If you want to use ollama for local inference, set the address of ollama API here. || OLLAMA_KEEP_ALIVE | No | Not set | Controls how long the model will stay loaded into memory following the request (examples: "5m" for 5 minutes, "-1m" to keep the model loaded indefinitely, "0" to unload the model instantly after processing is complete). || SEMANTIC_SEARCH_ENABLED | No | true | Enables the hybrid and semantic bookmark search modes. **Experimental.** `EMBEDDING_ENABLE_AUTO_INDEXING` must also be enabled. |-| INFERENCE_TEXT_MODEL | No | gpt-4.1-mini | The model to use for text inference. You'll need to change this to some other model if you're using ollama. |+| INFERENCE_TEXT_MODEL | No | gpt-5.6-luna | The model to use for text inference. You'll need to change this to some other model if you're using ollama. || INFERENCE_IMAGE_MODEL | No | gpt-4o-mini | The model to use for image inference. You'll need to change this to some other model if you're using ollama and that model needs to support vision APIs (e.g. llava). || EMBEDDING_ENABLE_AUTO_INDEXING | No | enabled if using OpenAI | Whether bookmark embedding generation and vector indexing are enabled. This is enabled by default if you're using the default OpenAI settings (i.e. no Ollama, no OpenAI base URL override). Otherwise, you need to manually enable it after configuring the embedding model and its dimensions. || EMBEDDING_OPENAI_API_KEY | No | `OPENAI_API_KEY` | The API key used for OpenAI-compatible embedding requests. If unset, embedding requests use `OPENAI_API_KEY`. |@@ -116,7 +116,7 @@ Either `OPENAI_API_KEY` or `OLLAMA_BASE_URL` need to be set for automatic taggin| EMBEDDING_JOB_TIMEOUT_SEC | No | 60 | How long to wait for an embedding generation and vector indexing job to finish before timing out. Increase this if your embedding provider or vector store is slow. || INFERENCE_CONTEXT_LENGTH | No | 2048 | The max number of tokens that we'll pass to the inference model. If your content is larger than this size, it'll be truncated to fit. The larger this value, the more of the content will be used in tag inference, but the more expensive the inference will be (money-wise on openAI and resource-wise on ollama). Check the model you're using for its max supported content size. || INFERENCE_MAX_OUTPUT_TOKENS | No | 2048 | The maximum number of tokens that the inference model is allowed to generate in its response. This controls the length of AI-generated content like tags and summaries. Increase this if you need longer responses, but be aware that higher values will increase costs (for OpenAI) and processing time. |-| INFERENCE_USE_MAX_COMPLETION_TOKENS | No | false | \[OpenAI Only\] Whether to use the newer `max_completion_tokens` parameter instead of the deprecated `max_tokens` parameter. Set to `true` if using GPT-5 or o-series models which require this. Will become the default in a future release. |+| INFERENCE_USE_MAX_COMPLETION_TOKENS | No | *Read description* | \[OpenAI Only\] Whether to use the newer `max_completion_tokens` parameter instead of the deprecated `max_tokens` parameter. Set to `true` if using GPT-5 models which require this. If using the default openai configuration (with 5.6 luna) this will be set to true, else defaults to false. || INFERENCE_LANG | No | english | The language in which the tags will be generated. || INFERENCE_NUM_WORKERS | No | 1 | Number of concurrent workers for AI inference tasks (tagging and summarization). Increase this if you have multiple AI inference requests and want to process them in parallel. || INFERENCE_ENABLE_AUTO_TAGGING | No | true | Whether automatic AI tagging is enabled or disabled. |diff --git a/docs/versioned_docs/version-v0.33.0/06-administration/09-chrome-image-migration.md b/docs/versioned_docs/version-v0.33.0/06-administration/09-chrome-image-migration.mdnew file mode 100644index 00000000..6ac1d674--- /dev/null+++ b/docs/versioned_docs/version-v0.33.0/06-administration/09-chrome-image-migration.md@@ -0,0 +1,49 @@+# Migrating to the Karakeep Chrome Image++Karakeep now publishes its own tested Chrome image instead of relying on the+unmaintained Alpine Chrome image. If you maintain a custom Compose file, update+the `chrome` service with the following diff:++```diff+ services:+ chrome:+- image: gcr.io/zenika-hub/alpine-chrome:124++ image: ghcr.io/karakeep-app/karakeep-chrome:release+ restart: unless-stopped++ init: true+ command:+- - --no-sandbox+ - --disable-gpu+ - --disable-dev-shm-usage+- - --remote-debugging-address=0.0.0.0+- - --remote-debugging-port=9222+ - --hide-scrollbars+ - --disable-blink-features=AutomationControlled+ - --window-size=1440,900+```++Removing the remote-debugging arguments is required. The new image's entrypoint+starts Chrome on an internal port and forwards container port `9222`; overriding+that port conflicts with the forwarding setup. The entrypoint also supplies+`--no-sandbox`, so removing the duplicate Compose argument does not enable the+Chromium sandbox.++The connection used by Karakeep does not change:++```yaml+environment:+ BROWSER_WEB_URL: http://chrome:9222+```++After editing the Compose file, pull and recreate the services:++```bash+docker compose pull chrome+docker compose up -d chrome+```++The migration does not change Karakeep data or require a database migration.+The `release` tag follows the browser image promoted for stable Karakeep+deployments. To control browser upgrades independently, replace `release` with+an immutable versioned tag from the+[Karakeep Chrome package](https://github.com/karakeep-app/karakeep/pkgs/container/karakeep-chrome).