Mattermost
v11.5.1
Self-hosted team messaging platform, alternative to Slack
What's included
- Mattermost 11.5.1 (fully configured, ready to use)
- Caddy web server with auto-HTTPS
- PostgreSQL database
- Automated admin and team setup
After install
- Login at the URL shown with admin credentials
- No setup wizard exposed to the internet
- Invite team members from the System Console
- Custom domain: MATTERMOST_HOST=chat.example.com
How the install works
Generated from the install script itself -- these are the exact phases it runs on your server.
- 1.Pre-flight checks
- 2.Opening firewall
- 3.Installing system dependencies
- 4.Installing Caddy
- 5.Installing PostgreSQL
- 6.Setting up database
- 7.Installing Mattermost
- 8.Configuring Mattermost
- 9.Starting Mattermost
- 10.Setting up admin
- 11.Configuring Caddy
Supported Operating Systems
Ubuntu 24Ubuntu 25Debian 12Debian 13Rocky 9Rocky 10Alma 9Alma 10
Requirements
- RAM
- 2GB minimum
- Disk
- 10GB minimum
Configuration
| Variable | Default | Description |
|---|---|---|
| MATTERMOST_HOST | server hostname | Domain name or IP. Domains get auto-HTTPS via Let's Encrypt. |
| MATTERMOST_ADMIN_USER | admin | Mattermost admin username |
| MATTERMOST_ADMIN_PASS | random 24-char | Mattermost admin password |
| MATTERMOST_ADMIN_EMAIL | admin@hostname | Mattermost admin email |
| MATTERMOST_DB_PASS | random 24-char | PostgreSQL password |
| MATTERMOST_TEAM_NAME | main | Initial team name |
14 installsOfficial website →
Changelog
v1.0.12026-07-12
- Rocky/Alma: fixed database auth (host pg_hba rules for the TCP connection)
- Mattermost bound to 127.0.0.1:8065 behind Caddy
- Re-runs no longer abort on an existing database or user
- Reliable Caddy config load (restart instead of enable --now)
v1.0.02026-04-02
- Initial release with Caddy + PostgreSQL
- Tarball-based install (x86_64)
- CLI-based admin and team setup (no web wizard exposed)
- Auto-HTTPS via Let's Encrypt
- Open signups disabled by default