{
  "schema_version": 1,
  "generated_at": "2026-10-23T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/karakeep",
  "slug": "karakeep",
  "name": "Karakeep",
  "tagline": "Bookmark manager that saves links, notes and images and can tag them with a language model.",
  "replaces": {
    "summary": "Paid read-later services, such as Pocket.",
    "products": [
      {
        "slug": "pocket",
        "name": "Pocket",
        "vendor": "Mozilla",
        "url": "https://openlogs.fyi/alternatives/pocket"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "TypeScript"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "AGPL-3.0",
    "class": "osi",
    "source_url": "https://github.com/karakeep-app/karakeep/blob/85054d9a67de08bc83029a2e960e0a0621fd715f/LICENSE"
  },
  "business_model": {
    "value": "unknown",
    "notes": "The README at the pinned commit does not state a business model, so it stays unknown.",
    "source_url": "https://github.com/karakeep-app/karakeep/blob/85054d9a67de08bc83029a2e960e0a0621fd715f/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "3 services (1 database or broker: meilisearch), 2 volume mounts, 1 env value to set, no elevated host access. Heuristic score 4 of 11: medium."
  },
  "repository": {
    "owner": "karakeep-app",
    "name": "karakeep",
    "url": "https://github.com/karakeep-app/karakeep"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "docker/docker-compose.yml",
    "source_repo": "karakeep-app/karakeep",
    "source_commit_sha": "85054d9a67de08bc83029a2e960e0a0621fd715f",
    "source_kind": "app_repo",
    "source_url": "https://github.com/karakeep-app/karakeep/blob/85054d9a67de08bc83029a2e960e0a0621fd715f/docker/docker-compose.yml"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin",
      "body": "A host with Docker and the Docker Compose plugin. This entry runs from a compose file.",
      "source_url": "https://github.com/karakeep-app/karakeep/blob/85054d9a67de08bc83029a2e960e0a0621fd715f/docs/docs/02-installation/01-docker.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "compose",
      "language": "yaml",
      "label": "Save the compose file as docker-compose.yml",
      "body": "services:\n  web:\n    image: ghcr.io/karakeep-app/karakeep:${KARAKEEP_VERSION:-release}\n    restart: unless-stopped\n    volumes:\n      # By default, the data is stored in a docker volume called \"data\".\n      # If you want to mount a custom directory, change the volume mapping to:\n      # - /path/to/your/directory:/data\n      - data:/data\n    ports:\n      - 3000:3000\n    env_file:\n      - .env\n    environment:\n      MEILI_ADDR: http://meilisearch:7700\n      BROWSER_WEB_URL: http://chrome:9222\n      # OPENAI_API_KEY: ...\n\n      # You almost never want to change the value of the DATA_DIR variable.\n      # If you want to mount a custom directory, change the volume mapping above instead.\n      DATA_DIR: /data # DON'T CHANGE THIS\n  chrome:\n    image: ghcr.io/karakeep-app/karakeep-chrome:release\n    restart: unless-stopped\n    init: true\n    command:\n      - --disable-gpu\n      - --disable-dev-shm-usage\n      - --hide-scrollbars\n      - --disable-blink-features=AutomationControlled\n      - --window-size=1440,900\n  meilisearch:\n    image: getmeili/meilisearch:v1.41.0\n    restart: unless-stopped\n    env_file:\n      - .env\n    environment:\n      MEILI_NO_ANALYTICS: \"true\"\n    volumes:\n      - meilisearch:/meili_data\n\nvolumes:\n  meilisearch:\n  data:\n",
      "source_url": "https://github.com/karakeep-app/karakeep/blob/85054d9a67de08bc83029a2e960e0a0621fd715f/docker/docker-compose.yml",
      "validation_status": "config_ok"
    },
    {
      "order": 3,
      "kind": "env",
      "language": "dotenv",
      "label": "Save as .env next to the compose file",
      "body": "KARAKEEP_VERSION=release\nNEXTAUTH_SECRET=super_random_string\nMEILI_MASTER_KEY=another_random_string\nNEXTAUTH_URL=http://localhost:3000\n",
      "source_url": "https://github.com/karakeep-app/karakeep/blob/85054d9a67de08bc83029a2e960e0a0621fd715f/docs/docs/02-installation/01-docker.md#L32-L37",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "note",
      "language": "text",
      "label": "What the compose file check ran with",
      "body": "The compose file check ran together with a .env file copied unchanged from the code block in https://github.com/karakeep-app/karakeep/blob/85054d9a67de08bc83029a2e960e0a0621fd715f/docs/docs/02-installation/01-docker.md#L32-L37. The folder held only these files. The Docker install guide tells the reader to download the compose file, create a .env file with the minimal settings shown and start the service.",
      "source_url": "https://github.com/karakeep-app/karakeep/blob/85054d9a67de08bc83029a2e960e0a0621fd715f/docs/docs/02-installation/01-docker.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 5,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/karakeep-app/karakeep/blob/85054d9a67de08bc83029a2e960e0a0621fd715f/docs/docs/02-installation/01-docker.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 6,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:3000. The compose file publishes host port 3000 for the web service.",
      "source_url": "https://github.com/karakeep-app/karakeep/blob/85054d9a67de08bc83029a2e960e0a0621fd715f/docker/docker-compose.yml",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 3000 (web). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/karakeep-app/karakeep/blob/85054d9a67de08bc83029a2e960e0a0621fd715f/docker/docker-compose.yml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 29884,
    "forks": 1588,
    "open_issues": 707,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "v0.34.1",
    "latest_release_date": "2026-10-22",
    "days_since_release": 0
  },
  "links": {
    "html": "https://openlogs.fyi/tools/karakeep",
    "markdown": "https://openlogs.fyi/tools/karakeep.md",
    "json": "https://openlogs.fyi/tools/karakeep.json"
  },
  "updated_at": "2026-10-22"
}