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.

Production Docker Setup on Ubuntu

1. 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
   

2. Deploy the Mattermost Production Docker setup by running:

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

3. Configure TLS by following the instructions

4. Configure Email by following the SMTP email setup guide

5. (Optional) to enable enterprise features under System Console > Edition and License upload your trial license or subscription license file received via email.

6. 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 Mac OS X

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

Other options: To install a feature-equivalent version of Mattermost that does not upgrade to enterprise features using a license key, Mattermost Team Edition, repeat steps above excluding -b enterprise from git clone command.