{
  "manifest_version": "1",
  "slug": "mattermost",
  "title": "Mattermost",
  "headline": "Self-host Mattermost",
  "description": "Run Mattermost on exe.dev: private team chat you sign in to with your exe.dev login, alerts from your other VMs, and an AI agent with no API key.",
  "category": "productivity",
  "tags": [
    "team chat",
    "slack alternative",
    "self-hosted chat",
    "chatops",
    "webhooks",
    "docker compose",
    "postgresql",
    "ai agents"
  ],
  "url": "https://exe.dev/deploy/mattermost",
  "markdown_url": "https://exe.dev/deploy/mattermost.md",
  "upstream": {
    "website": "https://mattermost.com",
    "source": "https://github.com/mattermost/mattermost",
    "docs": "https://docs.mattermost.com",
    "license": "MIT (Team Edition)"
  },
  "example_vm_name": "my-mattermost",
  "time": "15 minutes",
  "stack": [
    {
      "name": "Mattermost 12.1",
      "detail": "Team Edition, Docker Compose",
      "data": "~/mattermost/mattermost"
    },
    {
      "name": "nginx",
      "detail": "Lets in exe.dev logins and the apps' secret; carries websockets",
      "port": 8000
    },
    {
      "name": "exe-login",
      "detail": "Signs people in to Mattermost with their exe.dev login"
    },
    {
      "name": "PostgreSQL 18",
      "detail": "Messages, channels, people, settings",
      "data": "~/mattermost/postgres"
    },
    {
      "name": "smtp-relay",
      "detail": "Turns Mattermost's email into exe.dev email"
    },
    {
      "name": "Nightly backup",
      "detail": "A systemd timer; keeps two weeks of copies",
      "data": "~/mattermost/backups"
    }
  ],
  "access": [
    {
      "url": "https://my-mattermost.exe.xyz/",
      "who": "private",
      "what": "Mattermost in the browser, after exe.dev login, for you and anyone you share it with"
    },
    {
      "url": "https://my-mattermost.exe.xyz/hooks/",
      "who": "private",
      "what": "incoming webhooks, for your other VMs through a peer integration or VM token"
    }
  ],
  "delivers": [
    "Mattermost Team Edition on PostgreSQL, behind exe.dev login, with live updates.",
    "Sign-in with your exe.dev login, no Mattermost passwords; invite links just work.",
    "Uploaded files on the VM's disk, and the secrets in a private file.",
    "Email notifications and invites through exe.dev, with no mail service.",
    "A secret that lets the desktop and mobile apps in once you make the VM public.",
    "Nightly backups; everything restarts after a reboot."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe.dev/new?prompt=Set%20up%20Mattermost%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe.dev%2Fdeploy%2Fmattermost.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-mattermost.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-mattermost.%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-%20Mattermost%20Team%20Edition%20on%20PostgreSQL%2C%20behind%20exe.dev%20login%2C%20with%20live%20updates.%0A-%20Sign-in%20with%20your%20exe.dev%20login%2C%20no%20Mattermost%20passwords%3B%20invite%20links%20just%20work.%0A-%20Uploaded%20files%20on%20the%20VM%27s%20disk%2C%20and%20the%20secrets%20in%20a%20private%20file.%0A-%20Email%20notifications%20and%20invites%20through%20exe.dev%2C%20with%20no%20mail%20service.%0A-%20A%20secret%20that%20lets%20the%20desktop%20and%20mobile%20apps%20in%20once%20you%20make%20the%20VM%20public.%0A-%20Nightly%20backups%3B%20everything%20restarts%20after%20a%20reboot.%0A%0ARead%20the%20whole%20recipe%2C%20including%20closed%20details%2C%20and%20follow%20%22Install%20by%0Ahand%22%20first.%20The%20walkthrough%20at%20the%20top%20is%20for%20the%20owner%20afterwards.%0ADo%20not%20create%20a%20Mattermost%20account%20or%20sign%20in%20through%20exe-login%3A%20the%0Afirst%20account%20becomes%20the%20system%20admin%2C%20so%20leave%20it%20to%20the%20owner%2C%20and%0Adon%27t%20share%20the%20VM%20or%20make%20it%20public.%20Don%27t%20set%20up%20the%20AI%20agent%2C%0Awebhooks%2C%20or%20invites%2C%20or%20send%20email.%0ADo%20not%20run%20the%20later%20Restore%20or%20Update%20instructions.%0AWork%20as%20exedev%20in%20~%2Fmattermost.%20Verify%20docker.service%20is%20enabled%2C%20all%0Afive%20containers%20are%20up%20with%20mattermost%20and%20postgres%20healthy%2C%20and%20the%0Athree%20curl%20checks%20print%20%22OK%22%2C%20403%2C%20and%20a%20URL%20ending%20in%20%2Foauth%2Fgitlab%2Flogin.%20Check%20that%0Athe%20backup%20timer%20is%20enabled%20and%20the%20first%20archive%20lists%20mattermost.dump.%0AFinish%20with%20https%3A%2F%2F%3Cvm%3E.exe.xyz%2F%3A%20the%20owner%20opening%20it%20signs%20in%20as%20the%0Aadmin%20and%20names%20the%20team.%20Then%20point%20them%20to%20%22Add%20an%20AI%20agent%22.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe.dev/deploy/mattermost/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up Mattermost on this VM by following the exe.dev recipe at https://exe.dev/deploy/mattermost.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-mattermost. This VM's name is the output of `hostname`: use it wherever the recipe writes my-mattermost. 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- Mattermost Team Edition on PostgreSQL, behind exe.dev login, with live updates.\n- Sign-in with your exe.dev login, no Mattermost passwords; invite links just work.\n- Uploaded files on the VM's disk, and the secrets in a private file.\n- Email notifications and invites through exe.dev, with no mail service.\n- A secret that lets the desktop and mobile apps in once you make the VM public.\n- Nightly backups; everything restarts after a reboot.\n\nRead the whole recipe, including closed details, and follow \"Install by\nhand\" first. The walkthrough at the top is for the owner afterwards.\nDo not create a Mattermost account or sign in through exe-login: the\nfirst account becomes the system admin, so leave it to the owner, and\ndon't share the VM or make it public. Don't set up the AI agent,\nwebhooks, or invites, or send email.\nDo not run the later Restore or Update instructions.\nWork as exedev in ~/mattermost. Verify docker.service is enabled, all\nfive containers are up with mattermost and postgres healthy, and the\nthree curl checks print \"OK\", 403, and a URL ending in /oauth/gitlab/login. Check that\nthe backup timer is enabled and the first archive lists mattermost.dump.\nFinish with https://\u003cvm\u003e.exe.xyz/: the owner opening it signs in as the\nadmin and names the team. Then point them to \"Add an AI agent\".\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe.dev/deploy/mattermost/prompt.txt"
  },
  "updated": "2026-11-18",
  "verified": "2026-11-18",
  "related": [
    "uptime-kuma",
    "open-webui",
    "postgres",
    "docker-compose",
    "agent-secrets",
    "metabase"
  ],
  "alternatives": [
    "Slack",
    "Microsoft Teams",
    "Zulip",
    "Rocket.Chat"
  ],
  "files": [
    "https://exe.dev/deploy/mattermost/exe-login.py",
    "https://exe.dev/deploy/mattermost/nginx.conf.template"
  ]
}
