{
  "manifest_version": "1",
  "slug": "plane",
  "title": "Plane",
  "headline": "Self-host Plane",
  "description": "Run Plane Community Edition on an exe.dev VM: issues, cycles and pages for your team behind your exe.dev login, and agents that work them over MCP.",
  "category": "productivity",
  "tags": [
    "plane",
    "issue tracker",
    "project management",
    "jira alternative",
    "linear alternative",
    "sprints",
    "kanban",
    "mcp server",
    "docker compose",
    "postgresql"
  ],
  "url": "https://exe.dev/deploy/plane",
  "markdown_url": "https://exe-staging.dev/deploy/plane.md",
  "upstream": {
    "website": "https://plane.so",
    "source": "https://github.com/makeplane/plane",
    "docs": "https://developers.plane.so/self-hosting/overview",
    "license": "AGPL-3.0 (Community Edition)"
  },
  "example_vm_name": "my-plane",
  "time": "15 minutes",
  "stack": [
    {
      "name": "Plane 1.x",
      "detail": "Plane's official Docker Compose release: web app, god mode, API, workers, live server and a Caddy proxy on port 8080"
    },
    {
      "name": "nginx",
      "detail": "in front of Plane on 127.0.0.1:8000, routing exe.dev sign-in",
      "port": 8000
    },
    {
      "name": "exe-login",
      "detail": "a 150-line Python service that answers Plane's Gitea sign-in with the visitor's exe.dev identity, on 127.0.0.1:8002 and :8003"
    },
    {
      "name": "PostgreSQL 15",
      "detail": "postgres:15.7-alpine in the same Compose project",
      "data": "Docker volume plane_pgdata"
    },
    {
      "name": "Valkey, RabbitMQ, MinIO",
      "detail": "cache, task queue, and storage for uploaded files",
      "data": "Docker volume plane_uploads"
    },
    {
      "name": "Agent tools",
      "detail": "`plane-api` for the REST API, and Plane's MCP server for Claude Code and (through a local bridge on 127.0.0.1:8211) Shelley"
    },
    {
      "name": "Nightly backup",
      "detail": "a systemd timer: database dump, uploads and settings; keeps two weeks",
      "data": "~/plane-backups"
    }
  ],
  "access": [
    {
      "url": "https://my-plane.exe.xyz/",
      "who": "private",
      "what": "Plane, signed in with exe.dev, for you and the people you share the VM with and invite"
    },
    {
      "url": "https://my-plane.exe.xyz/god-mode/",
      "who": "private",
      "what": "instance settings, for the admin you create first, with a password"
    },
    {
      "url": "https://my-plane.exe.xyz/api/v1/",
      "who": "private",
      "what": "the REST API, for agents elsewhere with an exe.dev VM token and a Plane token"
    }
  ],
  "delivers": [
    "Plane Community Edition 1.x at `https://my-plane.exe.xyz/`, behind your exe.dev login, restarted after a reboot.",
    "Sign-in with exe.dev: no Plane passwords; the people you share the VM with and invite are signed in as themselves, with accounts created on their first visit.",
    "Open sign-up off from the start: you claim god mode, and everyone else joins by invitation.",
    "Secrets generated on the VM in `~/plane/.env` (mode 600), which also holds the agents' Plane token.",
    "`plane-api`, `plane-mcp` and a Shelley MCP bridge on the VM, ready for Claude Code and Shelley once there's a token.",
    "Nightly backups of the database, uploads and settings in `~/plane-backups`, with a restore checked in a scratch container."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20Plane%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fplane.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-plane.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-plane.%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-%20Plane%20Community%20Edition%201.x%20at%20%60https%3A%2F%2Fmy-plane.exe.xyz%2F%60%2C%20behind%20your%20exe.dev%20login%2C%20restarted%20after%20a%20reboot.%0A-%20Sign-in%20with%20exe.dev%3A%20no%20Plane%20passwords%3B%20the%20people%20you%20share%20the%20VM%20with%20and%20invite%20are%20signed%20in%20as%20themselves%2C%20with%20accounts%20created%20on%20their%20first%20visit.%0A-%20Open%20sign-up%20off%20from%20the%20start%3A%20you%20claim%20god%20mode%2C%20and%20everyone%20else%20joins%20by%20invitation.%0A-%20Secrets%20generated%20on%20the%20VM%20in%20%60~%2Fplane%2F.env%60%20%28mode%20600%29%2C%20which%20also%20holds%20the%20agents%27%20Plane%20token.%0A-%20%60plane-api%60%2C%20%60plane-mcp%60%20and%20a%20Shelley%20MCP%20bridge%20on%20the%20VM%2C%20ready%20for%20Claude%20Code%20and%20Shelley%20once%20there%27s%20a%20token.%0A-%20Nightly%20backups%20of%20the%20database%2C%20uploads%20and%20settings%20in%20%60~%2Fplane-backups%60%2C%20with%20a%20restore%20checked%20in%20a%20scratch%20container.%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%20create%20the%20god-mode%20admin%20or%20any%20Plane%20account%3A%20the%0Afirst%20admin%20must%20be%20the%20owner%2C%20with%20their%20exe.dev%20email.%20Don%27t%20make%0Athe%20VM%20public.%20The%20VM%20can%27t%0Areach%20its%20own%20https%3A%2F%2F%3Cvm%3E.exe.xyz%2C%20so%20check%20with%20http%3A%2F%2Flocalhost%3A8000%0Aas%20written.%20The%20first%20start%20runs%20database%20migrations%20for%20several%0Aminutes%3B%20wait%20for%20them.%20Don%27t%20enable%20plane-mcp.service%20or%20register%20MCP%0Aservers%20yet%3A%20there%27s%20no%20token%20until%20the%20owner%20makes%20one.%20Don%27t%20run%0ARestore%20or%20Update%2C%20and%20don%27t%20reboot.%20Finish%20with%20the%20god-mode%20URL%2C%20tell%0Athe%20owner%20to%20follow%20%22Claim%20your%20instance%22%2C%20and%20point%20them%20to%20%22Connect%0Ayour%20agents%22%20for%20the%20token.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/plane/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up Plane on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/plane.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-plane. This VM's name is the output of `hostname`: use it wherever the recipe writes my-plane. 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- Plane Community Edition 1.x at `https://my-plane.exe.xyz/`, behind your exe.dev login, restarted after a reboot.\n- Sign-in with exe.dev: no Plane passwords; the people you share the VM with and invite are signed in as themselves, with accounts created on their first visit.\n- Open sign-up off from the start: you claim god mode, and everyone else joins by invitation.\n- Secrets generated on the VM in `~/plane/.env` (mode 600), which also holds the agents' Plane token.\n- `plane-api`, `plane-mcp` and a Shelley MCP bridge on the VM, ready for Claude Code and Shelley once there's a token.\n- Nightly backups of the database, uploads and settings in `~/plane-backups`, with a restore checked in a scratch container.\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 create the god-mode admin or any Plane account: the\nfirst admin must be the owner, with their exe.dev email. Don't make\nthe VM public. The VM can't\nreach its own https://\u003cvm\u003e.exe.xyz, so check with http://localhost:8000\nas written. The first start runs database migrations for several\nminutes; wait for them. Don't enable plane-mcp.service or register MCP\nservers yet: there's no token until the owner makes one. Don't run\nRestore or Update, and don't reboot. Finish with the god-mode URL, tell\nthe owner to follow \"Claim your instance\", and point them to \"Connect\nyour agents\" for the token.\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe-staging.dev/deploy/plane/prompt.txt"
  },
  "updated": "2026-11-17",
  "verified": "2026-11-17",
  "related": [
    "issue-tracker",
    "kaneo",
    "openproject",
    "kanboard",
    "multica",
    "forgejo"
  ],
  "alternatives": [
    "Jira",
    "Linear",
    "Asana"
  ],
  "files": [
    "https://exe-staging.dev/deploy/plane/exe-login.py"
  ]
}
