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.