{
  "manifest_version": "1",
  "slug": "openproject",
  "title": "OpenProject",
  "headline": "Self-host OpenProject",
  "description": "Run OpenProject Community on an exe.dev VM: work packages, Gantt charts, boards and a wiki that sign your team in with exe.dev, an API for agents, nightly backups.",
  "category": "productivity",
  "tags": [
    "openproject",
    "project management",
    "gantt chart",
    "issue tracker",
    "jira alternative",
    "ms project alternative",
    "agile boards",
    "api v3",
    "postgresql",
    "header sso",
    "ldap"
  ],
  "url": "https://exe.dev/deploy/openproject",
  "markdown_url": "https://exe-staging.dev/deploy/openproject.md",
  "upstream": {
    "website": "https://www.openproject.org",
    "source": "https://github.com/opf/openproject",
    "docs": "https://www.openproject.org/docs/",
    "license": "GPL-3.0"
  },
  "example_vm_name": "my-openproject",
  "time": "15 minutes",
  "stack": [
    {
      "name": "OpenProject 17 Community",
      "detail": "the official all-in-one image `openproject/openproject:17` in Docker Compose: Rails, PostgreSQL 17, memcached and Apache in one container, on 127.0.0.1 only, signing people in from exe.dev's `X-ExeDev-Email` header",
      "port": 8000,
      "data": "~/openproject/pgdata, ~/openproject/assets"
    },
    {
      "name": "exe-ldap",
      "detail": "a 180-line read-only LDAP directory in Python (python:3.13-alpine), which OpenProject's header sign-in needs to create accounts; it answers for any email, refuses every password, and publishes no port",
      "data": "~/openproject/exe-ldap.py, ~/openproject/names.txt"
    },
    {
      "name": "Nightly backup",
      "detail": "a systemd timer; database dump, attachments and secrets; keeps two weeks",
      "data": "~/openproject/backups"
    }
  ],
  "access": [
    {
      "url": "https://my-openproject.exe.xyz/",
      "who": "private",
      "what": "OpenProject; exe.dev's login signs you in as its admin"
    },
    {
      "url": "https://my-openproject.exe.xyz/",
      "who": "shared",
      "what": "teammates you share the VM with, signed in as themselves, with an account made on their first visit"
    },
    {
      "url": "https://my-openproject.exe.xyz/api/v3/",
      "who": "private",
      "what": "API v3 for agents elsewhere, with an exe.dev VM token and an OpenProject API token"
    }
  ],
  "delivers": [
    "OpenProject 17 Community at `https://my-openproject.exe.xyz/`, behind your exe.dev login, back after a reboot.",
    "exe.dev login as OpenProject login: you are an admin, and anyone you share the VM with gets an account on first visit. No OpenProject passwords; the default `admin` account is locked.",
    "An `Agent` user with an API token in `~/openproject/.env` and an `op-api` helper, checked by creating, commenting on, closing and deleting a work package.",
    "Nightly backups of the database, attachments and secrets to `~/openproject/backups`, the first one checked."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20OpenProject%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fopenproject.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-openproject.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-openproject.%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-%20OpenProject%2017%20Community%20at%20%60https%3A%2F%2Fmy-openproject.exe.xyz%2F%60%2C%20behind%20your%20exe.dev%20login%2C%20back%20after%20a%20reboot.%0A-%20exe.dev%20login%20as%20OpenProject%20login%3A%20you%20are%20an%20admin%2C%20and%20anyone%20you%20share%20the%20VM%20with%20gets%20an%20account%20on%20first%20visit.%20No%20OpenProject%20passwords%3B%20the%20default%20%60admin%60%20account%20is%20locked.%0A-%20An%20%60Agent%60%20user%20with%20an%20API%20token%20in%20%60~%2Fopenproject%2F.env%60%20and%20an%20%60op-api%60%20helper%2C%20checked%20by%20creating%2C%20commenting%20on%2C%20closing%20and%20deleting%20a%20work%20package.%0A-%20Nightly%20backups%20of%20the%20database%2C%20attachments%20and%20secrets%20to%20%60~%2Fopenproject%2Fbackups%60%2C%20the%20first%20one%20checked.%0A%0ARead%20the%20whole%20recipe%2C%20closed%20details%20included%2C%20and%20follow%20%22Set%20up%20by%0Ahand%22%20in%20order%2C%20skipping%20VM%20creation.%20The%20walkthrough%20above%20it%20is%20for%0Athe%20owner%3A%20don%27t%20create%20projects%20or%20users%20beyond%20the%20setup%27s.%20The%0Aowner%20becomes%20OpenProject%27s%20admin%3A%20their%20exe.dev%20email%20comes%20from%20the%0Areflection%20integration%3B%20if%20it%20returns%20nothing%2C%20ask%20the%20owner%20for%20the%0Aemail%20they%20sign%20in%20to%20exe.dev%20with.%20Keep%20the%20VM%20private%3B%20never%20run%0Ashare%20set-public.%20On%20an%20existing%20VM%2C%20ask%20before%20replacing%20anything%20on%0Aport%208000.%20The%20first%20start%20takes%20about%20four%20minutes%3A%20wait%20with%20the%0Ahealth%20check%20as%20written.%20Never%20print%20the%20API%20token.%20Don%27t%20run%20the%0Arestore%20or%20update%20instructions%2C%20and%20don%27t%20reboot.%20Finish%20with%20the%20URL%2C%0Asay%20that%20exe.dev%27s%20login%20signs%20the%20owner%20in%20as%20admin%20and%20gives%20anyone%0Athey%20share%20the%20VM%20with%20an%20account%20on%20first%20visit%2C%20and%20point%20the%20owner%0Ato%20%22Let%20agents%20work%20on%20it%22.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/openproject/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up OpenProject on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/openproject.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-openproject. This VM's name is the output of `hostname`: use it wherever the recipe writes my-openproject. 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- OpenProject 17 Community at `https://my-openproject.exe.xyz/`, behind your exe.dev login, back after a reboot.\n- exe.dev login as OpenProject login: you are an admin, and anyone you share the VM with gets an account on first visit. No OpenProject passwords; the default `admin` account is locked.\n- An `Agent` user with an API token in `~/openproject/.env` and an `op-api` helper, checked by creating, commenting on, closing and deleting a work package.\n- Nightly backups of the database, attachments and secrets to `~/openproject/backups`, the first one checked.\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 projects or users beyond the setup's. The\nowner becomes OpenProject's admin: their exe.dev email comes from the\nreflection integration; if it returns nothing, ask the owner for the\nemail they sign in to exe.dev with. Keep the VM private; never run\nshare set-public. On an existing VM, ask before replacing anything on\nport 8000. The first start takes about four minutes: wait with the\nhealth check as written. Never print the API token. Don't run the\nrestore or update instructions, and don't reboot. Finish with the URL,\nsay that exe.dev's login signs the owner in as admin and gives anyone\nthey share the VM with an account on first visit, and point the owner\nto \"Let agents work on it\".\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe-staging.dev/deploy/openproject/prompt.txt"
  },
  "updated": "2026-11-17",
  "verified": "2026-11-17",
  "related": [
    "issue-tracker",
    "kanboard",
    "kaneo",
    "forgejo",
    "gitea",
    "cal-diy"
  ],
  "alternatives": [
    "Jira",
    "Microsoft Project",
    "Asana"
  ],
  "files": [
    "https://exe-staging.dev/deploy/openproject/exe-ldap.py"
  ]
}
