Production Docker Deployment¶

Deploy Mattermost using a multi-node production configuration using Docker Compose. Docker Compose experience recommended.

For a single-node preview of Mattermost (without email) see Local Machine Setup using Docker.

If you have any problems installing, see the troubleshooting guide. To submit an improvement or correction, click Edit at the top of this page.

Production Docker Setup on Ubuntu¶

Install Docker Compose using the Ubuntu online guide or these instructions:

sudo apt-get update
sudo apt-get install wget
wget -qO- https://get.docker.com/ | sh
sudo usermod -aG docker <username>
sudo service docker start
newgrp docker

Deploy the Mattermost Production Docker setup by running:

git clone https://github.com/mattermost/mattermost-docker.git
cd mattermost-docker
docker-compose build
docker-compose up -d

Configure TLS by following the instructions
Configure Email by following the SMTP email setup guide
(Optional) to enable enterprise features under System Console > Edition and License upload your trial license or subscription license file received via email.
Configure your server based on configuration settings documentation

Additional Guides:

Start, stop and remove containers using management instructions.
Setup Database Backup following the database backup instructions.

Production Docker Setup on Arch Linux¶

To install on Arch Linux, see the installation guide on the Arch Linux wiki.

Production Docker Setup on Mac OS X¶

You can run a production deployment on Mac OS X by installing Docker Compose using the online guide then following the above instructions.

Other options:¶

To install Mattermost Team Edition instead of Mattermost Enterprise Edition, open docker-compose.yaml and comment out the following line:

dockerfile: Dockerfile-enterprise