{
  "manifest_version": "1",
  "slug": "supabase",
  "title": "Supabase",
  "headline": "Self-host Supabase",
  "description": "Run self-hosted Supabase on an exe.dev VM: Postgres, Auth, Storage, Realtime and Studio, with a private dashboard, a public API, and nightly backups.",
  "category": "databases",
  "tags": [
    "supabase",
    "firebase alternative",
    "postgresql",
    "backend as a service",
    "auth",
    "docker compose"
  ],
  "url": "https://exe.dev/deploy/supabase",
  "markdown_url": "https://exe.dev/deploy/supabase.md",
  "upstream": {
    "website": "https://supabase.com",
    "source": "https://github.com/supabase/supabase",
    "docs": "https://supabase.com/docs/guides/self-hosting/docker",
    "license": "Apache-2.0"
  },
  "example_vm_name": "my-supabase",
  "time": "15 minutes",
  "stack": [
    {
      "name": "Supabase self-hosted v0.8.4",
      "detail": "Postgres 17, Auth, PostgREST, Realtime, Storage, Edge Functions, and Studio, in Supabase's own Docker Compose setup",
      "data": "~/supabase/volumes"
    },
    {
      "name": "API gateway (Envoy)",
      "detail": "Studio, behind a dashboard password, and every API",
      "port": 8001
    },
    {
      "name": "Front door (Caddy)",
      "detail": "Passes Supabase's API paths to the gateway, and nothing else",
      "port": 8000
    },
    {
      "name": "exe.dev LLM gateway",
      "detail": "Powers Studio's AI Assistant, with no OpenAI key"
    }
  ],
  "access": [
    {
      "url": "https://my-supabase.exe.xyz:8001/",
      "who": "private",
      "what": "Studio, after exe.dev login and the dashboard password"
    },
    {
      "url": "https://my-supabase.exe.xyz/",
      "who": "private",
      "what": "The API (/rest/v1, /auth/v1, /storage/v1, ...); make it public when apps elsewhere need it"
    }
  ],
  "delivers": [
    "Supabase v0.8.4 running in Docker Compose, with its own generated secrets and keys in `~/supabase/.env` (mode 600), and coming back after a reboot.",
    "Studio at `https://\u003cvm\u003e.exe.xyz:8001/`, behind exe.dev login and the dashboard password, showing a `notes` table with one row.",
    "The API on port 8000 answering `GET /rest/v1/notes` with the publishable key, and refusing Studio and `/pg/` paths.",
    "Studio's AI Assistant answering through exe.dev's LLM gateway.",
    "The Supabase CLI and rclone installed, and `supabase-backup.timer` saving the database and files to `~/backups` nightly, with a first backup made."
  ],
  "owner_runs_after": [
    "ssh exe.dev share set-public my-supabase"
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe.dev/new?prompt=Set%20up%20Supabase%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe.dev%2Fdeploy%2Fsupabase.md%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-supabase.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-supabase.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AThis%20recipe%20needs%20a%2040GB%20disk%2C%20and%20a%20new%20VM%27s%20may%20be%20smaller.%20Before%20you%20install%20anything%2C%20run%20%60df%20-h%20%2F%60.%20If%20its%20size%20is%20under%2036G%2C%20stop%20and%20ask%20me%20to%20grow%20the%20disk%2C%20either%20with%20this%20link%3A%20https%3A%2F%2Fexe.dev%2Fsuggest%3Fcommand%3Dresize%2520my-supabase%2520--disk%253D40GB%20or%2C%20on%20my%20computer%2C%20with%20%60ssh%20exe.dev%20resize%20my-supabase%20--disk%3D40GB%60.%20When%20I%20say%20it%27s%20done%2C%20run%20%60sudo%20resize2fs%20%22%24%28findmnt%20-no%20SOURCE%20%2F%29%22%60%2C%20check%20%60df%20-h%20%2F%60%20again%2C%20and%20carry%20on.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20Supabase%20v0.8.4%20running%20in%20Docker%20Compose%2C%20with%20its%20own%20generated%20secrets%20and%20keys%20in%20%60~%2Fsupabase%2F.env%60%20%28mode%20600%29%2C%20and%20coming%20back%20after%20a%20reboot.%0A-%20Studio%20at%20%60https%3A%2F%2F%3Cvm%3E.exe.xyz%3A8001%2F%60%2C%20behind%20exe.dev%20login%20and%20the%20dashboard%20password%2C%20showing%20a%20%60notes%60%20table%20with%20one%20row.%0A-%20The%20API%20on%20port%208000%20answering%20%60GET%20%2Frest%2Fv1%2Fnotes%60%20with%20the%20publishable%20key%2C%20and%20refusing%20Studio%20and%20%60%2Fpg%2F%60%20paths.%0A-%20Studio%27s%20AI%20Assistant%20answering%20through%20exe.dev%27s%20LLM%20gateway.%0A-%20The%20Supabase%20CLI%20and%20rclone%20installed%2C%20and%20%60supabase-backup.timer%60%20saving%20the%20database%20and%20files%20to%20%60~%2Fbackups%60%20nightly%2C%20with%20a%20first%20backup%20made.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20For%20initial%20setup%2C%0Afollow%20%22Install%20by%20hand%22%20first%2C%20skipping%20VM%20creation%20and%20SSH%2C%20through%20the%0Afirst%20backup.%20The%20walkthrough%20at%20the%20top%20is%20for%20the%20owner%20afterwards.%20Do%0Anot%20run%20the%20email%20hook%2C%20SMTP%2C%20S3%2C%20Cloud%20move%2C%20Restore%2C%20or%20Update%20sections%0Aunless%20the%20user%20asks.%0ANever%20print%20~%2Fsupabase%2F.env%20or%20setup.sh%27s%20secret%20output%20into%20the%20chat%3B%20tell%0Athe%20owner%20where%20the%20dashboard%20password%20is%20%28%60grep%20DASHBOARD%20~%2Fsupabase%2F.env%60%29.%0ADon%27t%20make%20the%20VM%20public%20or%20share%20it%3A%20the%20owner%20decides.%20Leave%20the%20%60notes%60%0Atable%20in%20place%20so%20the%20owner%20can%20see%20it%20in%20Studio.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open%20and%20these%20commands%2C%20which%20only%20I%20can%20run%2C%20from%20my%20own%20computer%20%28with%20this%20VM%27s%20name%20in%20them%29%3A%0A%20%20ssh%20exe.dev%20share%20set-public%20my-supabase%0A",
    "disk": "40GB",
    "terminal": "curl -fsSL https://exe.dev/deploy/supabase/prompt.txt | ssh exe.dev new --disk=40GB --prompt=/dev/stdin",
    "prompt": "Set up Supabase on this VM by following the exe.dev recipe at https://exe.dev/deploy/supabase.md from top to bottom.\n\nThe recipe's example VM name is my-supabase. This VM's name is the output of `hostname`: use it wherever the recipe writes my-supabase. Skip the step that creates the VM; you are on it.\n\nThis recipe needs a 40GB disk, and a new VM's may be smaller. Before you install anything, run `df -h /`. If its size is under 36G, stop and ask me to grow the disk, either with this link: https://exe.dev/suggest?command=resize%20my-supabase%20--disk%3D40GB or, on my computer, with `ssh exe.dev resize my-supabase --disk=40GB`. When I say it's done, run `sudo resize2fs \"$(findmnt -no SOURCE /)\"`, check `df -h /` again, and carry on.\n\nYou are done when all of these are true. Check each one yourself:\n- Supabase v0.8.4 running in Docker Compose, with its own generated secrets and keys in `~/supabase/.env` (mode 600), and coming back after a reboot.\n- Studio at `https://\u003cvm\u003e.exe.xyz:8001/`, behind exe.dev login and the dashboard password, showing a `notes` table with one row.\n- The API on port 8000 answering `GET /rest/v1/notes` with the publishable key, and refusing Studio and `/pg/` paths.\n- Studio's AI Assistant answering through exe.dev's LLM gateway.\n- The Supabase CLI and rclone installed, and `supabase-backup.timer` saving the database and files to `~/backups` nightly, with a first backup made.\n\nRead the whole recipe, including the closed details. For initial setup,\nfollow \"Install by hand\" first, skipping VM creation and SSH, through the\nfirst backup. The walkthrough at the top is for the owner afterwards. Do\nnot run the email hook, SMTP, S3, Cloud move, Restore, or Update sections\nunless the user asks.\nNever print ~/supabase/.env or setup.sh's secret output into the chat; tell\nthe owner where the dashboard password is (`grep DASHBOARD ~/supabase/.env`).\nDon't make the VM public or share it: the owner decides. Leave the `notes`\ntable in place so the owner can see it in Studio.\n\nFinish with the URLs I should open and these commands, which only I can run, from my own computer (with this VM's name in them):\n  ssh exe.dev share set-public my-supabase\n",
    "prompt_url": "https://exe.dev/deploy/supabase/prompt.txt"
  },
  "updated": "2026-11-16",
  "verified": "2026-11-16",
  "related": [
    "migrate-lovable",
    "postgres",
    "nextjs",
    "nodejs",
    "docker-compose",
    "agent-secrets"
  ],
  "alternatives": [
    "Supabase Cloud",
    "Firebase"
  ]
}
