{
  "schema_version": 1,
  "generated_at": "2026-10-23T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/pocket-id",
  "slug": "pocket-id",
  "name": "Pocket ID",
  "tagline": "Single sign-on server that signs users in with passkeys.",
  "replaces": {
    "summary": "Paid identity and login services, such as Okta.",
    "products": [
      {
        "slug": "okta",
        "name": "Okta",
        "vendor": "Okta",
        "url": "https://openlogs.fyi/alternatives/okta"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "Go"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "BSD-2-Clause",
    "class": "osi",
    "source_url": "https://github.com/pocket-id/pocket-id/blob/b023bc3d57adbe1f0bf087c3171d7ced58db9991/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/pocket-id/pocket-id/blob/b023bc3d57adbe1f0bf087c3171d7ced58db9991/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "easy",
    "reason": "1 service, 1 volume mount, 1 env value to set, no elevated host access. Heuristic score 1 of 11: easy."
  },
  "repository": {
    "owner": "pocket-id",
    "name": "pocket-id",
    "url": "https://github.com/pocket-id/pocket-id"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "docker-compose.yml",
    "source_repo": "pocket-id/pocket-id",
    "source_commit_sha": "b023bc3d57adbe1f0bf087c3171d7ced58db9991",
    "source_kind": "app_repo",
    "source_url": "https://github.com/pocket-id/pocket-id/blob/b023bc3d57adbe1f0bf087c3171d7ced58db9991/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/pocket-id/website/blob/71182329deb7386342b8293a8aef7055ba2aac4e/src/content/docs/docs/setup/installation.mdx",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "compose",
      "language": "yaml",
      "label": "Save the compose file as docker-compose.yml",
      "body": "services:\n  pocket-id:\n    image: pocketid/pocket-id:v2 # or ghcr.io/pocket-id/pocket-id:v2\n    restart: unless-stopped\n    env_file: .env\n    ports:\n      - 1411:1411\n    volumes:\n      - \"./data:/app/data\"\n    # Optional healthcheck\n    healthcheck:\n      test: [ \"CMD\", \"/app/pocket-id\", \"healthcheck\" ]\n      interval: 1m30s\n      timeout: 5s\n      retries: 2\n      start_period: 10s\n",
      "source_url": "https://github.com/pocket-id/pocket-id/blob/b023bc3d57adbe1f0bf087c3171d7ced58db9991/docker-compose.yml",
      "validation_status": "config_ok"
    },
    {
      "order": 3,
      "kind": "env",
      "language": "dotenv",
      "label": "Save as .env next to the compose file",
      "body": "# See the documentation for more information: https://pocket-id.org/docs/configuration/environment-variables\n\n# These variables must be configured for your deployment:\nAPP_URL=https://your-pocket-id-domain.com\n\n# Encryption key (choose one method):\n# Method 1: Direct key (simple but less secure)\n# Generate with: openssl rand -base64 32\nENCRYPTION_KEY=\n# Method 2: File-based key (recommended)\n# Put the base64 key in a file and point to it here.\n# ENCRYPTION_KEY_FILE=/path/to/encryption_key\n\n# These variables are optional but recommended to review:\nTRUST_PROXY=false\nMAXMIND_LICENSE_KEY=\nPUID=1000\nPGID=1000\n",
      "source_url": "https://github.com/pocket-id/pocket-id/blob/b023bc3d57adbe1f0bf087c3171d7ced58db9991/.env.example",
      "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 .env.example from the same commit, saved as .env. The folder held only these files. The installation guide tells the reader to download docker-compose.yml and .env.example (saved as .env), set the address and an encryption key in .env and run docker compose up -d.",
      "source_url": "https://github.com/pocket-id/website/blob/71182329deb7386342b8293a8aef7055ba2aac4e/src/content/docs/docs/setup/installation.mdx",
      "validation_status": "unvalidated"
    },
    {
      "order": 5,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/pocket-id/website/blob/71182329deb7386342b8293a8aef7055ba2aac4e/src/content/docs/docs/setup/installation.mdx",
      "validation_status": "unvalidated"
    },
    {
      "order": 6,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:1411. The compose file publishes host port 1411 for the pocket-id service.",
      "source_url": "https://github.com/pocket-id/pocket-id/blob/b023bc3d57adbe1f0bf087c3171d7ced58db9991/docker-compose.yml",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 1411 (pocket-id). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/pocket-id/pocket-id/blob/b023bc3d57adbe1f0bf087c3171d7ced58db9991/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file mounts host folders",
      "body": "Host paths mounted into containers: ./data at /app/data (pocket-id).",
      "source_url": "https://github.com/pocket-id/pocket-id/blob/b023bc3d57adbe1f0bf087c3171d7ced58db9991/docker-compose.yml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 9669,
    "forks": 342,
    "open_issues": 103,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "v2.19.1",
    "latest_release_date": "2026-10-22",
    "days_since_release": 0
  },
  "links": {
    "html": "https://openlogs.fyi/tools/pocket-id",
    "markdown": "https://openlogs.fyi/tools/pocket-id.md",
    "json": "https://openlogs.fyi/tools/pocket-id.json"
  },
  "updated_at": "2026-10-22"
}