{
  "manifest_version": "1",
  "slug": "temporal",
  "title": "Temporal",
  "headline": "Self-host Temporal",
  "description": "Run the Temporal server on an exe.dev VM: Docker Compose with PostgreSQL, the Web UI behind exe.dev login, a Python worker under systemd, and backups.",
  "category": "automation",
  "tags": [
    "temporal",
    "temporal self-host",
    "temporal docker",
    "temporal server",
    "durable execution",
    "workflow engine",
    "temporal web ui",
    "postgresql"
  ],
  "url": "https://exe.dev/deploy/temporal",
  "markdown_url": "https://exe-staging.dev/deploy/temporal.md",
  "upstream": {
    "website": "https://temporal.io",
    "source": "https://github.com/temporalio/temporal",
    "docs": "https://docs.temporal.io",
    "license": "MIT"
  },
  "example_vm_name": "my-temporal",
  "time": "10 minutes",
  "stack": [
    {
      "name": "Temporal Server 1.32",
      "detail": "temporalio/server in Docker Compose; gRPC frontend on localhost",
      "port": 7233
    },
    {
      "name": "PostgreSQL 16",
      "detail": "Workflow state and visibility, in Docker Compose",
      "data": "~/temporal/postgres"
    },
    {
      "name": "Temporal Web UI 2.58",
      "detail": "temporalio/ui, through exe.dev's HTTPS proxy",
      "port": 8000
    },
    {
      "name": "HTTP API",
      "detail": "The server's HTTP/JSON API, for clients that can't speak gRPC",
      "port": 7243
    },
    {
      "name": "Python worker",
      "detail": "A demo worker on the temporalio SDK, run by systemd",
      "data": "~/temporal-worker"
    },
    {
      "name": "Nightly backups",
      "detail": "pg_dump of both databases, 14 nights kept",
      "data": "~/temporal/backups"
    }
  ],
  "access": [
    {
      "url": "https://my-temporal.exe.xyz/",
      "who": "private",
      "what": "The Temporal Web UI, behind exe.dev login"
    },
    {
      "url": "https://my-temporal.exe.xyz:7243/",
      "who": "private",
      "what": "The HTTP API, for programs that send an exe.dev VM token"
    },
    {
      "url": "localhost:7233",
      "who": "private",
      "what": "The gRPC frontend for workers and the CLI on the VM (or over SSH or Tailscale)"
    }
  ],
  "delivers": [
    "Temporal Server 1.32.2, PostgreSQL 16 and the Web UI 2.58.1 in Docker Compose, restarted after a reboot, with every port on localhost only.",
    "The `temporal` CLI 1.10.1 on the VM, and a `default` namespace that keeps closed workflows for 7 days.",
    "The Web UI at `https://\u003cvm\u003e.exe.xyz/`, private behind exe.dev login.",
    "A Python worker for the `demo` task queue in `~/temporal-worker`, run by systemd, and one `Pipeline` workflow completed through it.",
    "Nightly backups of both databases to `~/temporal/backups`, one restored and checked."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20Temporal%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Ftemporal.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-temporal.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-temporal.%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-%20Temporal%20Server%201.32.2%2C%20PostgreSQL%2016%20and%20the%20Web%20UI%202.58.1%20in%20Docker%20Compose%2C%20restarted%20after%20a%20reboot%2C%20with%20every%20port%20on%20localhost%20only.%0A-%20The%20%60temporal%60%20CLI%201.10.1%20on%20the%20VM%2C%20and%20a%20%60default%60%20namespace%20that%20keeps%20closed%20workflows%20for%207%20days.%0A-%20The%20Web%20UI%20at%20%60https%3A%2F%2F%3Cvm%3E.exe.xyz%2F%60%2C%20private%20behind%20exe.dev%20login.%0A-%20A%20Python%20worker%20for%20the%20%60demo%60%20task%20queue%20in%20%60~%2Ftemporal-worker%60%2C%20run%20by%20systemd%2C%20and%20one%20%60Pipeline%60%20workflow%20completed%20through%20it.%0A-%20Nightly%20backups%20of%20both%20databases%20to%20%60~%2Ftemporal%2Fbackups%60%2C%20one%20restored%20and%20checked.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20For%20initial%20setup%2C%0Afollow%20%22Install%20by%20hand%22%20from%20top%20to%20bottom%2C%20skipping%20VM%20creation%3A%0ADocker%2C%20the%20CLI%2C%20the%20Compose%20project%2C%20the%20namespace%2C%20the%20worker%20and%20its%0Acheck%2C%20the%20backup%20timer%2C%20and%20the%20restore%20test.%20The%20walkthrough%20sections%0Aare%20for%20the%20owner%20afterwards%3A%20don%27t%20stop%20the%20worker%2C%20run%20the%20Summarize%0Aworkflow%2C%20set%20up%20Tailscale%20or%20the%20dev%20server%2C%20or%20run%20the%20Restore%20or%0AUpdate%20instructions%20during%20initial%20setup.%20Never%20overwrite%20an%20existing%0A~%2Ftemporal%2F.env.%20Leave%20the%20VM%20private%20and%20do%20not%20reboot.%20Don%27t%20paste%20the%0APostgreSQL%20password%20into%20the%20chat.%20Finish%20with%20https%3A%2F%2F%3Cvm%3E.exe.xyz%2F%0Aand%20the%20steps%20in%20%22Watch%20a%20workflow%20survive%20a%20crash%22.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/temporal/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up Temporal on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/temporal.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-temporal. This VM's name is the output of `hostname`: use it wherever the recipe writes my-temporal. 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- Temporal Server 1.32.2, PostgreSQL 16 and the Web UI 2.58.1 in Docker Compose, restarted after a reboot, with every port on localhost only.\n- The `temporal` CLI 1.10.1 on the VM, and a `default` namespace that keeps closed workflows for 7 days.\n- The Web UI at `https://\u003cvm\u003e.exe.xyz/`, private behind exe.dev login.\n- A Python worker for the `demo` task queue in `~/temporal-worker`, run by systemd, and one `Pipeline` workflow completed through it.\n- Nightly backups of both databases to `~/temporal/backups`, one restored and checked.\n\nRead the whole recipe, including the closed details. For initial setup,\nfollow \"Install by hand\" from top to bottom, skipping VM creation:\nDocker, the CLI, the Compose project, the namespace, the worker and its\ncheck, the backup timer, and the restore test. The walkthrough sections\nare for the owner afterwards: don't stop the worker, run the Summarize\nworkflow, set up Tailscale or the dev server, or run the Restore or\nUpdate instructions during initial setup. Never overwrite an existing\n~/temporal/.env. Leave the VM private and do not reboot. Don't paste the\nPostgreSQL password into the chat. Finish with https://\u003cvm\u003e.exe.xyz/\nand the steps in \"Watch a workflow survive a crash\".\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe-staging.dev/deploy/temporal/prompt.txt"
  },
  "published": "2026-11-21",
  "updated": "2026-11-21",
  "verified": "2026-11-21",
  "related": [
    "postgres",
    "docker-compose",
    "go",
    "nodejs",
    "fastapi",
    "grafana"
  ],
  "alternatives": [
    "Temporal Cloud",
    "AWS Step Functions"
  ],
  "files": [
    "https://exe-staging.dev/deploy/temporal/backup.sh",
    "https://exe-staging.dev/deploy/temporal/compose.yaml",
    "https://exe-staging.dev/deploy/temporal/dynamic.yaml",
    "https://exe-staging.dev/deploy/temporal/worker.py"
  ]
}
