{
  "manifest_version": "1",
  "slug": "cloudflare-workers",
  "title": "OpenOrange",
  "headline": "Self-host Cloudflare Workers with OpenOrange",
  "description": "Run your Cloudflare Worker and its Durable Objects unchanged on an exe.dev VM with OpenOrange and a self-hosted Rivet Engine: KV, crons and Workers AI.",
  "category": "serverless",
  "tags": [
    "cloudflare workers",
    "durable objects",
    "self-host cloudflare workers",
    "openorange",
    "rivet",
    "wrangler",
    "workers ai",
    "migrate off cloudflare"
  ],
  "url": "https://exe.dev/deploy/cloudflare-workers",
  "markdown_url": "https://exe.dev/deploy/cloudflare-workers.md",
  "upstream": {
    "website": "https://openorange.dev",
    "source": "https://github.com/rivet-dev/open-orange",
    "docs": "https://openorange.dev/docs/",
    "license": "Apache-2.0"
  },
  "example_vm_name": "my-workers",
  "time": "15 minutes",
  "stack": [
    {
      "name": "Rivet Engine 3.1",
      "detail": "rivetdev/engine in Docker Compose; places and stores every Durable Object",
      "port": 6420,
      "data": "~/orange/data"
    },
    {
      "name": "Your Worker",
      "detail": "an image built by `orange deploy --dry-run`, running `orange serve`",
      "port": 8000,
      "data": "~/app"
    },
    {
      "name": "Secrets",
      "detail": "what `wrangler secret put` held, one file, mode 600",
      "data": "~/orange/secrets.env"
    }
  ],
  "access": [
    {
      "url": "https://my-workers.exe.xyz/",
      "who": "private",
      "what": "your Worker, until you open it to everyone or move your domain"
    },
    {
      "url": "https://my-workers.exe.xyz:8787/",
      "who": "private",
      "what": "`orange dev`, while you run it"
    }
  ],
  "delivers": [
    "The Rivet Engine and a sample Worker (a chat with one Durable Object per room, KV, a cron trigger and Workers AI) running in Docker Compose, back after a reboot.",
    "The Worker at `https://\u003cvm\u003e.exe.xyz/`, private behind exe.dev login, signing messages with the visitor's exe.dev email.",
    "Workers AI answering through exe.dev's LLM integration, with no API key on the VM.",
    "A `~/orange/deploy` command that builds any Worker project and rolls it out.",
    "A backup of the Engine's data, secrets and code in `~/backups`."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe.dev/new?prompt=Set%20up%20OpenOrange%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe.dev%2Fdeploy%2Fcloudflare-workers.md%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-workers.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-workers.%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-%20The%20Rivet%20Engine%20and%20a%20sample%20Worker%20%28a%20chat%20with%20one%20Durable%20Object%20per%20room%2C%20KV%2C%20a%20cron%20trigger%20and%20Workers%20AI%29%20running%20in%20Docker%20Compose%2C%20back%20after%20a%20reboot.%0A-%20The%20Worker%20at%20%60https%3A%2F%2F%3Cvm%3E.exe.xyz%2F%60%2C%20private%20behind%20exe.dev%20login%2C%20signing%20messages%20with%20the%20visitor%27s%20exe.dev%20email.%0A-%20Workers%20AI%20answering%20through%20exe.dev%27s%20LLM%20integration%2C%20with%20no%20API%20key%20on%20the%20VM.%0A-%20A%20%60~%2Forange%2Fdeploy%60%20command%20that%20builds%20any%20Worker%20project%20and%20rolls%20it%20out.%0A-%20A%20backup%20of%20the%20Engine%27s%20data%2C%20secrets%20and%20code%20in%20%60~%2Fbackups%60.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20Do%20%22Install%20by%20hand%22%0Afirst%2C%20skipping%20VM%20creation%3B%20the%20sections%20above%20it%20are%20for%20the%20owner.%0ADo%20not%20run%20the%20Restore%2C%20Update%20or%20%22Move%20a%20Worker%20off%20Cloudflare%22%20steps.%0ANever%20print%20RIVET_TOKEN%20or%20the%20contents%20of%20secrets.env.%0AKeep%20the%20VM%20private%3B%20do%20not%20run%20share%20set-public.%0ACheck%20that%20%60curl%20-s%20localhost%3A8000%2Fapi%2Froom%2Flobby%60%20shows%20a%20message%20you%0Aposted%2C%20that%20the%20summary%20route%20answers%2C%20that%20both%20containers%20are%20up%0Aafter%20%60docker%20compose%20restart%60%2C%20and%20that%20docker.service%20is%20enabled.%0AMake%20the%20first%20backup.%20Finish%20with%20https%3A%2F%2F%3Cvm%3E.exe.xyz%2F%2C%20using%20this%0AVM%27s%20name%2C%20and%20tell%20the%20owner%20to%20put%20their%20own%20Worker%20in%20~%2Fapp%20%28or%0Aanywhere%29%20and%20run%20~%2Forange%2Fdeploy%20on%20it.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe.dev/deploy/cloudflare-workers/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up OpenOrange on this VM by following the exe.dev recipe at https://exe.dev/deploy/cloudflare-workers.md from top to bottom.\n\nThe recipe's example VM name is my-workers. This VM's name is the output of `hostname`: use it wherever the recipe writes my-workers. 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- The Rivet Engine and a sample Worker (a chat with one Durable Object per room, KV, a cron trigger and Workers AI) running in Docker Compose, back after a reboot.\n- The Worker at `https://\u003cvm\u003e.exe.xyz/`, private behind exe.dev login, signing messages with the visitor's exe.dev email.\n- Workers AI answering through exe.dev's LLM integration, with no API key on the VM.\n- A `~/orange/deploy` command that builds any Worker project and rolls it out.\n- A backup of the Engine's data, secrets and code in `~/backups`.\n\nRead the whole recipe, including the closed details. Do \"Install by hand\"\nfirst, skipping VM creation; the sections above it are for the owner.\nDo not run the Restore, Update or \"Move a Worker off Cloudflare\" steps.\nNever print RIVET_TOKEN or the contents of secrets.env.\nKeep the VM private; do not run share set-public.\nCheck that `curl -s localhost:8000/api/room/lobby` shows a message you\nposted, that the summary route answers, that both containers are up\nafter `docker compose restart`, and that docker.service is enabled.\nMake the first backup. Finish with https://\u003cvm\u003e.exe.xyz/, using this\nVM's name, and tell the owner to put their own Worker in ~/app (or\nanywhere) and run ~/orange/deploy on it.\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe.dev/deploy/cloudflare-workers/prompt.txt"
  },
  "updated": "2026-11-15",
  "verified": "2026-11-15",
  "related": [
    "celld",
    "migrate-durable-objects",
    "docker-compose",
    "claude-code",
    "n8n-2",
    "openclaw"
  ],
  "alternatives": [
    "Cloudflare Workers"
  ],
  "files": [
    "https://exe.dev/deploy/cloudflare-workers/compose.yaml",
    "https://exe.dev/deploy/cloudflare-workers/deploy",
    "https://exe.dev/deploy/cloudflare-workers/index.js",
    "https://exe.dev/deploy/cloudflare-workers/rivet.json",
    "https://exe.dev/deploy/cloudflare-workers/wrangler.jsonc"
  ]
}
