{
  "manifest_version": "1",
  "slug": "sentry",
  "title": "Sentry",
  "headline": "Self-host Sentry",
  "description": "Run Sentry's official self-hosted release on an exe.dev VM: errors, performance, Session Replay and crons, with a private dashboard and token-protected ingest.",
  "category": "monitoring",
  "tags": [
    "sentry",
    "self-hosted sentry",
    "error tracking",
    "session replay",
    "performance monitoring",
    "exception monitoring",
    "sentry sdk",
    "docker compose"
  ],
  "url": "https://exe.dev/deploy/sentry",
  "markdown_url": "https://exe-staging.dev/deploy/sentry.md",
  "upstream": {
    "website": "https://sentry.io",
    "source": "https://github.com/getsentry/self-hosted",
    "docs": "https://develop.sentry.dev/self-hosted/",
    "license": "FSL-1.1-Apache-2.0"
  },
  "example_vm_name": "my-sentry",
  "time": "30 minutes",
  "stack": [
    {
      "name": "Sentry 26.11.0",
      "detail": "getsentry/self-hosted, the official Docker Compose release (about fifty containers)",
      "port": 9000,
      "data": "Docker volumes sentry-*"
    },
    {
      "name": "Relay, Kafka, ClickHouse, PostgreSQL, Redis",
      "detail": "Sentry's ingest, queue, event store, database and cache, all from the release"
    },
    {
      "name": "Ingest proxy",
      "detail": "nginx; the SDK endpoints and nothing else",
      "port": 8000
    },
    {
      "name": "Mail relay",
      "detail": "SMTP in, exe.dev's email gateway out; no SMTP account"
    },
    {
      "name": "Nightly backup",
      "detail": "Sentry's own export of users, projects and settings, from a systemd timer",
      "data": "~/sentry-backups"
    }
  ],
  "access": [
    {
      "url": "https://my-sentry.exe.xyz:9000/",
      "who": "private",
      "what": "The Sentry dashboard, behind exe.dev login and Sentry's own"
    },
    {
      "url": "https://my-sentry.exe.xyz/",
      "who": "private",
      "what": "Where SDKs send events; apps get in with a VM token, or browsers once you make it public"
    }
  ],
  "delivers": [
    "Sentry 26.11.0, every feature of the self-hosted release, restarted after a reboot.",
    "A private dashboard on port 9000 and an ingest-only address on the VM's main URL.",
    "Sentry's email (alerts, invitations) delivered through exe.dev, with no SMTP account.",
    "A nightly export of users, projects and settings, with the secret key beside it."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20Sentry%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fsentry.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-sentry.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-sentry.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AThis%20recipe%20needs%20a%20100GB%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%2090G%2C%20stop%20and%20ask%20me%20to%20grow%20the%20disk%2C%20either%20with%20this%20link%3A%20https%3A%2F%2Fexe.dev%2Fsuggest%3Fcommand%3Dresize%2520my-sentry%2520--disk%253D100GB%20or%2C%20on%20my%20computer%2C%20with%20%60ssh%20exe.dev%20resize%20my-sentry%20--disk%3D100GB%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-%20Sentry%2026.11.0%2C%20every%20feature%20of%20the%20self-hosted%20release%2C%20restarted%20after%20a%20reboot.%0A-%20A%20private%20dashboard%20on%20port%209000%20and%20an%20ingest-only%20address%20on%20the%20VM%27s%20main%20URL.%0A-%20Sentry%27s%20email%20%28alerts%2C%20invitations%29%20delivered%20through%20exe.dev%2C%20with%20no%20SMTP%20account.%0A-%20A%20nightly%20export%20of%20users%2C%20projects%20and%20settings%2C%20with%20the%20secret%20key%20beside%20it.%0A%0ARead%20the%20whole%20recipe%2C%20including%20closed%20details%2C%20and%20follow%20%22Install%20by%0Ahand%22%20first.%20The%20opening%20walkthrough%20is%20for%20the%20owner%20afterwards.%20Do%20not%0Arun%20the%20later%20Restore%20or%20Update%20instructions.%0ADo%20%22Check%20the%20size%22%20before%20installing%3A%20if%20the%20VM%20has%20fewer%20than%204%0AvCPUs%2C%20under%2015%20GB%20of%20memory%20or%20under%2095G%20of%20disk%2C%20stop%20and%20give%20the%0Aowner%20the%20resize%20link%20from%20that%20step%2C%20with%20this%20VM%27s%20name%3B%20continue%20when%0Athey%20say%20it%27s%20done.%20The%20installer%20takes%2015%20to%2030%20minutes%3B%20run%20it%20in%20tmux%0Aand%20wait%20for%20it.%20Work%20as%20exedev%20in%20~%2Fsentry.%0ADo%20not%20create%20a%20Sentry%20user%2C%20projects%20or%20send%20test%20email%3A%20the%20owner%20does%0Athat.%20Leave%20sharing%20alone%3B%20the%20VM%20stays%20private.%20Verify%20docker.service%20is%0Aenabled%2C%20%60docker%20compose%20ps%60%20shows%20every%20service%20up%2C%20localhost%3A9000%2Fauth%2Flogin%2F%0Aanswers%20200%2C%20localhost%3A8000%2F%20answers%20200%20with%20the%20ingest%20message%2C%20and%0Alocalhost%3A8000%2Fauth%2Flogin%2F%20and%20localhost%3A8000%2Fapi%2F0%2F%20return%20404.%20Check%20the%0Abackup%20timer%20is%20enabled%20and%20the%20first%20export%20exists%20in%20~%2Fsentry-backups.%0AFinish%20with%20the%20dashboard%20URL%20on%20port%209000%20and%20the%20createuser%20command%20from%0A%22Create%20your%20account%22%20for%20the%20owner%20to%20run.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "disk": "100GB",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/sentry/prompt.txt | ssh exe.dev new --disk=100GB --prompt=/dev/stdin",
    "prompt": "Set up Sentry on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/sentry.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-sentry. This VM's name is the output of `hostname`: use it wherever the recipe writes my-sentry. Skip the step that creates the VM; you are on it.\n\nThis recipe needs a 100GB disk, and a new VM's may be smaller. Before you install anything, run `df -h /`. If its size is under 90G, stop and ask me to grow the disk, either with this link: https://exe.dev/suggest?command=resize%20my-sentry%20--disk%3D100GB or, on my computer, with `ssh exe.dev resize my-sentry --disk=100GB`. 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- Sentry 26.11.0, every feature of the self-hosted release, restarted after a reboot.\n- A private dashboard on port 9000 and an ingest-only address on the VM's main URL.\n- Sentry's email (alerts, invitations) delivered through exe.dev, with no SMTP account.\n- A nightly export of users, projects and settings, with the secret key beside it.\n\nRead the whole recipe, including closed details, and follow \"Install by\nhand\" first. The opening walkthrough is for the owner afterwards. Do not\nrun the later Restore or Update instructions.\nDo \"Check the size\" before installing: if the VM has fewer than 4\nvCPUs, under 15 GB of memory or under 95G of disk, stop and give the\nowner the resize link from that step, with this VM's name; continue when\nthey say it's done. The installer takes 15 to 30 minutes; run it in tmux\nand wait for it. Work as exedev in ~/sentry.\nDo not create a Sentry user, projects or send test email: the owner does\nthat. Leave sharing alone; the VM stays private. Verify docker.service is\nenabled, `docker compose ps` shows every service up, localhost:9000/auth/login/\nanswers 200, localhost:8000/ answers 200 with the ingest message, and\nlocalhost:8000/auth/login/ and localhost:8000/api/0/ return 404. Check the\nbackup timer is enabled and the first export exists in ~/sentry-backups.\nFinish with the dashboard URL on port 9000 and the createuser command from\n\"Create your account\" for the owner to run.\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe-staging.dev/deploy/sentry/prompt.txt"
  },
  "updated": "2026-11-19",
  "verified": "2026-11-19",
  "related": [
    "sentry-glitchtip",
    "uptime-kuma",
    "grafana",
    "django",
    "fastapi",
    "nodejs"
  ],
  "alternatives": [
    "Sentry SaaS",
    "GlitchTip",
    "Rollbar",
    "Bugsnag"
  ],
  "files": [
    "https://exe-staging.dev/deploy/sentry/mail-relay.py"
  ]
}
