Docker deployment troubleshooting#

Permission issues on M1 Mac#

If you’re deploying the Mattermost server using Docker on an M1 Mac and encountering permission issues in the Docker container, re-create the required directories and set their permissions, then skip the following command because it causes the deploy to stop working.

sudo chown -R 2000:2000 ./volumes/app/mattermost

If you’re experiencing issues deploying on Docker generally, ensure the docker daemon is enabled and running:

sudo systemctl enable --now docker

To remove all data and settings for your Mattermost deployment:

sudo rm -rf ./volumes

TLS and NGINX issues#

For an in-depth guide to configuring the TLS certificate and key for NGINX, please refer to this document in the repository.

Install a different version of Mattermost#

  1. Shut down your deployment.

  2. Run git pull to fetch any recent changes to the repository, paying attention to any potential env.example changes.

  3. Adjust the MATTERMOST_IMAGE_TAG in the .env file to point your desired enterprise or team image version.

  4. Redeploy Mattermost.

Upgrading from mattermost-docker#

For an in-depth guide to upgrading from the deprecated mattermost-docker repository, please refer to this document. For additional help, please refer to this issue.