{
  "manifest_version": "1",
  "slug": "chatwoot",
  "title": "Chatwoot",
  "headline": "Self-host Chatwoot",
  "description": "Run Chatwoot's support inbox on exe.dev: a private agent dashboard, a public chat widget, email through exe.dev, and AI reply help with no API key.",
  "category": "productivity",
  "tags": [
    "customer support",
    "live chat",
    "help desk",
    "shared inbox",
    "intercom alternative",
    "zendesk alternative",
    "chat widget",
    "rails",
    "postgresql",
    "docker compose"
  ],
  "url": "https://exe.dev/deploy/chatwoot",
  "markdown_url": "https://exe-staging.dev/deploy/chatwoot.md",
  "upstream": {
    "website": "https://www.chatwoot.com",
    "source": "https://github.com/chatwoot/chatwoot",
    "docs": "https://www.chatwoot.com/docs/self-hosted",
    "license": "MIT (Community Edition)"
  },
  "example_vm_name": "my-chatwoot",
  "time": "20 minutes",
  "stack": [
    {
      "name": "Chatwoot 4.20",
      "detail": "chatwoot/chatwoot, the Rails app (dashboard, widget, APIs) and Sidekiq jobs",
      "port": 3000,
      "data": "~/chatwoot/storage"
    },
    {
      "name": "PostgreSQL 16 with pgvector",
      "detail": "Conversations, contacts, settings",
      "data": "~/chatwoot/postgres"
    },
    {
      "name": "Redis 8",
      "detail": "Job queue, live updates, cache",
      "data": "~/chatwoot/redis"
    },
    {
      "name": "Public proxy",
      "detail": "nginx; the widget, public APIs and webhooks, nothing else",
      "port": 8000
    },
    {
      "name": "Mail bridges",
      "detail": "SMTP out through exe.dev's email gateway, ~/Maildir in to Chatwoot"
    },
    {
      "name": "Nightly backup",
      "detail": "Database, files and keys from a systemd timer; keeps 14",
      "data": "~/chatwoot-backups"
    }
  ],
  "access": [
    {
      "url": "https://my-chatwoot.exe.xyz:3000/",
      "who": "private",
      "what": "The agent dashboard, behind exe.dev login and Chatwoot's own"
    },
    {
      "url": "https://my-chatwoot.exe.xyz/",
      "who": "private",
      "what": "Chat widget, public APIs and webhooks; make it public to put the widget on your website"
    }
  ],
  "delivers": [
    "Chatwoot 4.20 on PostgreSQL and Redis, back after a reboot.",
    "A dashboard only you and the people you share with can open, and a public address that serves the widget and nothing more.",
    "An email inbox at your VM's address, with replies sent through exe.dev and no mail provider.",
    "AI reply suggestions, summaries and rewrites through exe.dev's LLM gateway, no API key.",
    "Nightly backups of the database, uploads and encryption keys, with a test restore."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20Chatwoot%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fchatwoot.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-chatwoot.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-chatwoot.%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-%20Chatwoot%204.20%20on%20PostgreSQL%20and%20Redis%2C%20back%20after%20a%20reboot.%0A-%20A%20dashboard%20only%20you%20and%20the%20people%20you%20share%20with%20can%20open%2C%20and%20a%20public%20address%20that%20serves%20the%20widget%20and%20nothing%20more.%0A-%20An%20email%20inbox%20at%20your%20VM%27s%20address%2C%20with%20replies%20sent%20through%20exe.dev%20and%20no%20mail%20provider.%0A-%20AI%20reply%20suggestions%2C%20summaries%20and%20rewrites%20through%20exe.dev%27s%20LLM%20gateway%2C%20no%20API%20key.%0A-%20Nightly%20backups%20of%20the%20database%2C%20uploads%20and%20encryption%20keys%2C%20with%20a%20test%20restore.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details%2C%20and%20follow%20%22Install%0Aby%20hand%22%20first.%20The%20walkthrough%20before%20it%20is%20for%20the%20owner%20afterwards.%20Do%0Anot%20run%20the%20AI%20bot%2C%20Restore%20or%20Update%20instructions%20during%20setup.%0AWork%20as%20exedev%20in%20~%2Fchatwoot.%20Never%20overwrite%20an%20existing%20~%2Fchatwoot%2F.env%3A%0Ait%20holds%20the%20encryption%20keys.%20Do%20not%20create%20the%20Chatwoot%20admin%20account%2C%0Ainboxes%20or%20agents%3B%20the%20owner%20does%20that%20in%20the%20browser.%20Leave%20sharing%0Aalone%3A%20don%27t%20run%20share%20set-public%20or%20share%20receive-email.%0AVerify%20docker.service%20is%20enabled%20and%20every%20container%20is%20running%20with%0Arestart%20unless-stopped%3B%20localhost%3A3000%2Fapi%20reports%20version%204.20.0%3B%0Alocalhost%3A8000%2Fpacks%2Fjs%2Fsdk.js%20and%20%2Fhealth%20return%20200%20while%0Alocalhost%3A8000%2Fapp%2Flogin%20and%20%2Fsuper_admin%20redirect%20to%20port%203000.%20Check%0Athe%20Captain%20settings%20point%20at%20https%3A%2F%2Fllm.int.exe.xyz%20and%20the%20gateway%0Aanswers%20from%20the%20rails%20container.%20Check%20the%20backup%20timer%20is%20enabled%2C%0Athen%20restore%20the%20first%20backup%20only%20in%20the%20scratch%20directory%20and%20remove%20it.%0AFinish%20with%20the%20dashboard%20URL%20on%20port%203000%2C%20tell%20the%20owner%20to%20sign%20up%0Athere%20with%20their%20exe.dev%20email%20address%2C%20and%20give%20these%20OPTIONAL%20commands%0Afor%20their%20own%20computer%3A%20ssh%20exe.dev%20share%20receive-email%20my-chatwoot%20on%0A%28email%20inbox%29%20and%20ssh%20exe.dev%20share%20set-public%20my-chatwoot%20%28widget%20on%20a%0Apublic%20website%29.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/chatwoot/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up Chatwoot on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/chatwoot.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-chatwoot. This VM's name is the output of `hostname`: use it wherever the recipe writes my-chatwoot. 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- Chatwoot 4.20 on PostgreSQL and Redis, back after a reboot.\n- A dashboard only you and the people you share with can open, and a public address that serves the widget and nothing more.\n- An email inbox at your VM's address, with replies sent through exe.dev and no mail provider.\n- AI reply suggestions, summaries and rewrites through exe.dev's LLM gateway, no API key.\n- Nightly backups of the database, uploads and encryption keys, with a test restore.\n\nRead the whole recipe, including the closed details, and follow \"Install\nby hand\" first. The walkthrough before it is for the owner afterwards. Do\nnot run the AI bot, Restore or Update instructions during setup.\nWork as exedev in ~/chatwoot. Never overwrite an existing ~/chatwoot/.env:\nit holds the encryption keys. Do not create the Chatwoot admin account,\ninboxes or agents; the owner does that in the browser. Leave sharing\nalone: don't run share set-public or share receive-email.\nVerify docker.service is enabled and every container is running with\nrestart unless-stopped; localhost:3000/api reports version 4.20.0;\nlocalhost:8000/packs/js/sdk.js and /health return 200 while\nlocalhost:8000/app/login and /super_admin redirect to port 3000. Check\nthe Captain settings point at https://llm.int.exe.xyz and the gateway\nanswers from the rails container. Check the backup timer is enabled,\nthen restore the first backup only in the scratch directory and remove it.\nFinish with the dashboard URL on port 3000, tell the owner to sign up\nthere with their exe.dev email address, and give these OPTIONAL commands\nfor their own computer: ssh exe.dev share receive-email my-chatwoot on\n(email inbox) and ssh exe.dev share set-public my-chatwoot (widget on a\npublic website).\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe-staging.dev/deploy/chatwoot/prompt.txt"
  },
  "published": "2026-11-19",
  "updated": "2026-11-18",
  "verified": "2026-11-18",
  "related": [
    "n8n-2",
    "metabase",
    "open-webui",
    "cal-diy",
    "uptime-kuma",
    "rails"
  ],
  "alternatives": [
    "Intercom",
    "Zendesk",
    "Freshdesk",
    "Help Scout"
  ],
  "files": [
    "https://exe-staging.dev/deploy/chatwoot/bot.py",
    "https://exe-staging.dev/deploy/chatwoot/mail-to-chatwoot.py",
    "https://exe-staging.dev/deploy/chatwoot/smtp-relay.py",
    "https://exe-staging.dev/deploy/chatwoot/try.html"
  ]
}
