How to install Mattermost on a Cloud VPS

Mattermost is an open-source team messaging platform (a Slack alternative) with channels, calls, playbooks and integrations, self-hosted.

Self-hosted communication keeps your team conversations on your own server, with full data control and no history limits.

One-click install on cloudlinux.ro

The fastest way: Mattermost installs automatically at the first boot of a new server.

1. Create a Cloud VPS from the control panel.
2. In the configuration step, pick Mattermost from the app catalog.
3. Start the server. The install runs in the background for a few minutes and its status shows on the server page.
4. Access details and generated passwords are saved on the server in /root/app-credentials.txt. The app will be available on port 8065.

Manual install on any Ubuntu server

If you prefer doing it yourself, below is the exact script our automatic install runs. Execute it as root on a fresh Ubuntu server (24.04 recommended). It stops at the first error, and when it finishes you will find the access details in /root/app-credentials.txt.

export DEBIAN_FRONTEND=noninteractive
curl -fsSL https://get.docker.com | sh
DB_PASS=$(openssl rand -base64 24 | tr -dc 'A-Za-z0-9' | cut -c1-20)
docker network create mm
docker volume create mm_db
docker volume create mm_data
docker run -d --name mm-db --restart=always --network mm \
  -e POSTGRES_DB=mattermost -e POSTGRES_USER=mmuser -e POSTGRES_PASSWORD="$DB_PASS" \
  -v mm_db:/var/lib/postgresql/data postgres:16
docker run -d --name mattermost --restart=always --network mm -p 8065:8065 \
  -e MM_SQLSETTINGS_DRIVERNAME=postgres \
  -e MM_SQLSETTINGS_DATASOURCE="postgres://mmuser:${DB_PASS}@mm-db:5432/mattermost?sslmode=disable" \
  -v mm_data:/mattermost/data mattermost/mattermost-team-edition:latest
IP=$(hostname -I | awk '{print $1}')
printf 'Mattermost: http://%s:8065\nCreeaza contul de administrator la prima accesare.\n' "$IP" > /root/app-credentials.txt

You can also save this script as a recipe in your account and reuse it on any new server.