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¶
Shut down your deployment.
Run
git pull
to fetch any recent changes to the repository, paying attention to any potentialenv.example
changes.Adjust the
MATTERMOST_IMAGE_TAG
in the.env
file to point your desired enterprise or team image version.Important
For production environments, we recommend using specific version tags such as
MATTERMOST_IMAGE_TAG=release-10.5
rather than generic tags likeMATTERMOST_IMAGE_TAG=release-10
. Genericrelease-x
tags are intended for development use only and do not automatically receive new patch releases within that major version. Using specific version tags ensures a more reproducible and deterministic environment for your production deployment.Redeploy Mattermost.
Unintentional version downgrades¶
If you experience an unintentional downgrade when using generic MATTERMOST_IMAGE_TAG=release-x
tags, this is because these tags are designed for development use and may not point to the latest patch release within that major version.
Solution: Use a more specific version tag for your Docker image, such as MATTERMOST_IMAGE_TAG=release-10.5
, to avoid unexpected version changes and ensure consistent deployments.
Note
A pipeline improvement is in progress to ensure that generic release-x
tags are updated to the latest version from the corresponding release branch. Once this improvement is implemented, the behavior of these tags will be more predictable.
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.