{
  "manifest_version": "1",
  "slug": "kaneo",
  "title": "Kaneo",
  "headline": "Self-host Kaneo",
  "description": "Run Kaneo, the MIT-licensed issue tracker, on an exe.dev VM: boards, backlog and Gantt, signed in with exe.dev, agents on its CLI and MCP.",
  "category": "productivity",
  "tags": [
    "kaneo",
    "issue tracker",
    "project management",
    "kanban board",
    "jira alternative",
    "linear alternative",
    "mcp server",
    "docker compose",
    "postgresql"
  ],
  "url": "https://exe.dev/deploy/kaneo",
  "markdown_url": "https://exe-staging.dev/deploy/kaneo.md",
  "upstream": {
    "website": "https://kaneo.app",
    "source": "https://github.com/usekaneo/kaneo",
    "docs": "https://kaneo.app/docs/core",
    "license": "MIT"
  },
  "example_vm_name": "my-kaneo",
  "time": "10 minutes",
  "stack": [
    {
      "name": "Kaneo 2",
      "detail": "ghcr.io/usekaneo/kaneo:2 in Docker Compose: the web app, REST API and MCP endpoint in one container"
    },
    {
      "name": "Dex",
      "detail": "ghcr.io/dexidp/dex: an OpenID Connect provider that signs people in to Kaneo from exe.dev's login headers"
    },
    {
      "name": "nginx",
      "detail": "nginx:stable-alpine on 127.0.0.1:8000: /dex/ to Dex, everything else to Kaneo",
      "port": 8000
    },
    {
      "name": "PostgreSQL 16",
      "detail": "postgres:16-alpine in Docker Compose",
      "data": "Docker volume kaneo_postgres_data"
    },
    {
      "name": "Agent tools",
      "detail": "the `kaneo` CLI and `kaneo-mcp` (the official @kaneo/mcp server, in a Node 24 container), both using the API key in ~/kaneo/.env"
    },
    {
      "name": "Nightly backup",
      "detail": "a systemd timer running pg_dump; keeps two weeks",
      "data": "~/kaneo/backups"
    }
  ],
  "access": [
    {
      "url": "https://my-kaneo.exe.xyz/",
      "who": "private",
      "what": "Kaneo, signed in with your exe.dev login"
    },
    {
      "url": "https://my-kaneo.exe.xyz/api/",
      "who": "private",
      "what": "the REST API, for agents elsewhere with an exe.dev VM token and a Kaneo API key"
    }
  ],
  "delivers": [
    "Kaneo 2 with PostgreSQL at `https://my-kaneo.exe.xyz/`, behind your exe.dev login, restarted after a reboot.",
    "Sign-in with exe.dev, through Dex: no Kaneo passwords. Your account becomes the admin; teammates you invite get theirs on their first visit.",
    "Secrets generated on the VM in `~/kaneo/.env` (mode 600), which is also where the agents' API key goes.",
    "The `kaneo` CLI and the `kaneo-mcp` MCP server on the VM, ready for Claude Code, Codex and Shelley once there's an API key.",
    "Nightly database backups in `~/kaneo/backups`, keeping two weeks."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20Kaneo%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fkaneo.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-kaneo.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-kaneo.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20Kaneo%202%20with%20PostgreSQL%20at%20%60https%3A%2F%2Fmy-kaneo.exe.xyz%2F%60%2C%20behind%20your%20exe.dev%20login%2C%20restarted%20after%20a%20reboot.%0A-%20Sign-in%20with%20exe.dev%2C%20through%20Dex%3A%20no%20Kaneo%20passwords.%20Your%20account%20becomes%20the%20admin%3B%20teammates%20you%20invite%20get%20theirs%20on%20their%20first%20visit.%0A-%20Secrets%20generated%20on%20the%20VM%20in%20%60~%2Fkaneo%2F.env%60%20%28mode%20600%29%2C%20which%20is%20also%20where%20the%20agents%27%20API%20key%20goes.%0A-%20The%20%60kaneo%60%20CLI%20and%20the%20%60kaneo-mcp%60%20MCP%20server%20on%20the%20VM%2C%20ready%20for%20Claude%20Code%2C%20Codex%20and%20Shelley%20once%20there%27s%20an%20API%20key.%0A-%20Nightly%20database%20backups%20in%20%60~%2Fkaneo%2Fbackups%60%2C%20keeping%20two%20weeks.%0A%0ARead%20the%20whole%20recipe%2C%20closed%20details%20included%2C%20and%20follow%20%22Set%20up%20by%0Ahand%22%20in%20order%2C%20skipping%20VM%20creation%3B%20the%20walkthrough%20above%20it%20is%20for%0Athe%20owner.%20Don%27t%20sign%20in%20to%20Kaneo%20or%20send%20requests%20with%20X-ExeDev%0Aheaders%20other%20than%20the%20check%20as%20written%3A%20the%20first%20account%20becomes%20the%0Ainstance%20admin%2C%20and%20that%20must%20be%20the%20owner.%20Don%27t%20make%20the%20VM%20public.%0AThe%20VM%20can%27t%20reach%20its%20own%20https%3A%2F%2F%3Cvm%3E.exe.xyz%2C%20so%20check%20with%0Ahttp%3A%2F%2Flocalhost%3A8000%20as%20written.%20Don%27t%20run%20Restore%20or%20Update.%20Finish%0Awith%20Kaneo%27s%20URL%2C%20tell%20the%20owner%20to%20open%20it%20first%20to%20become%20the%20admin%0A%28choosing%20%22Continue%20with%20exe.dev%22%20if%20Kaneo%20shows%20a%20setup%20form%29%2C%20and%0Apoint%20them%20to%20%22Connect%20your%20agents%22%20for%20the%20API%20key.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/kaneo/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up Kaneo on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/kaneo.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-kaneo. This VM's name is the output of `hostname`: use it wherever the recipe writes my-kaneo. Skip the step that creates the VM; you are on it.\n\nYou are done when all of these are true. Check each one yourself:\n- Kaneo 2 with PostgreSQL at `https://my-kaneo.exe.xyz/`, behind your exe.dev login, restarted after a reboot.\n- Sign-in with exe.dev, through Dex: no Kaneo passwords. Your account becomes the admin; teammates you invite get theirs on their first visit.\n- Secrets generated on the VM in `~/kaneo/.env` (mode 600), which is also where the agents' API key goes.\n- The `kaneo` CLI and the `kaneo-mcp` MCP server on the VM, ready for Claude Code, Codex and Shelley once there's an API key.\n- Nightly database backups in `~/kaneo/backups`, keeping two weeks.\n\nRead the whole recipe, closed details included, and follow \"Set up by\nhand\" in order, skipping VM creation; the walkthrough above it is for\nthe owner. Don't sign in to Kaneo or send requests with X-ExeDev\nheaders other than the check as written: the first account becomes the\ninstance admin, and that must be the owner. Don't make the VM public.\nThe VM can't reach its own https://\u003cvm\u003e.exe.xyz, so check with\nhttp://localhost:8000 as written. Don't run Restore or Update. Finish\nwith Kaneo's URL, tell the owner to open it first to become the admin\n(choosing \"Continue with exe.dev\" if Kaneo shows a setup form), and\npoint them to \"Connect your agents\" for the API key.\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe-staging.dev/deploy/kaneo/prompt.txt"
  },
  "updated": "2026-11-17",
  "verified": "2026-11-17",
  "related": [
    "issue-tracker",
    "plane",
    "kanboard",
    "openproject",
    "kanzo",
    "forgejo"
  ],
  "alternatives": [
    "Jira",
    "Linear",
    "Trello"
  ]
}
