Manual fork of official GitHub repository for docker deployment of Mattermost https://github.com/mattermost/mattermost-docker
This repository has been archived on 2021-08-31. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
2017-01-30 16:51:36 -08:00
app Update Dockerfile 2017-01-20 10:54:45 -05:00
contrib/kubernetes k8s: Move files for k8s into contrib directory 2016-10-08 19:12:56 +09:00
db Export vars to fix the postgres container error 2017-01-30 15:57:17 -08:00
web Updated nginx ssl config to provide correct X-Forwared-Proto header 2016-10-15 13:29:13 +02:00
.travis.yml app: Make it works without volume mounting 2016-06-17 00:12:15 +09:00
docker-compose-v1.yml Update docker-compose file to v2 format (#62) 2016-12-20 00:13:02 -08:00
docker-compose.yml Update docker-compose file to v2 format (#62) 2016-12-20 00:13:02 -08:00
Dockerrun.aws.json aws: Upgrade to Mattermost 3.1.0 2016-06-21 19:20:34 +09:00
LICENSE Add README and LICENSE 2015-11-30 17:58:11 +09:00
README.aws.md Support aws beanstalk 2016-04-25 00:36:38 +09:00
README.md Add non-docker install doc link 2017-01-30 16:51:36 -08:00

Dockerfiles for Mattermost in production

See README.aws.md if you want to install it on AWS Elastic Beanstalk.

Build Status

Requirements

Installation

For the people who want to install Mattermost in a traditional way (without docker), please refer to the guide here: https://docs.mattermost.com/guides/administrator.html#installing-mattermost

Install with SSL certificate

  1. Open docker-compose.yml and set MATTERMOST_ENABLE_SSL to true.

    environment:
      - MATTERMOST_ENABLE_SSL=true
    
  2. Put your SSL certificate as ./volumes/web/cert/cert.pem and the private key that has no password as ./volumes/web/cert/key-no-password.pem. If you don't have them you may generate a self-signed SSL certificate.

  3. Build and run mattermost

    docker-compose up -d

  4. Open https://your.domain with your web browser.

Install without SSL certificate

  1. Open docker-compose.yml and set MATTERMOST_ENABLE_SSL to false.

    environment:
      - MATTERMOST_ENABLE_SSL=false
    
  2. Build and run mattermost

    docker-compose up -d

  3. Open http://your.domain with your web browser.

Starting/Stopping

Start

docker-compose start

Stop

docker-compose stop

Removing

Remove the containers

docker-compose stop && docker-compose rm

Remove the data and settings of your mattermost instance

sudo rm -rf volumes

Database Backup

When AWS S3 environment variables are specified on db docker container, it enables Wal-E backup to S3.

docker run -d --name mattermost-db \
    -e AWS_ACCESS_KEY_ID=XXXX \
    -e AWS_SECRET_ACCESS_KEY=XXXX \
    -e WALE_S3_PREFIX=s3://BUCKET_NAME/PATH \
    -e AWS_REGION=us-east-1
    -v ./volumes/db/var/lib/postgresql/data:/var/lib/postgresql/data
    -v /etc/localtime:/etc/localtime:ro
    db

All four environment variables are required. It will enable completed WAL segments sent to archive storage (S3). The base backup and clean up can be done through the following command:

# base backup
docker exec mattermost-db su - postgres sh -c "/usr/bin/envdir /etc/wal-e.d/env /usr/local/bin/wal-e backup-push /var/lib/postgresql/data"
# keep the most recent 7 base backups and remove the old ones
docker exec mattermost-db su - postgres sh -c "/usr/bin/envdir /etc/wal-e.d/env /usr/local/bin/wal-e delete --confirm retain 7"

Those tasks can be executed through a cron job or systemd timer.

Upgrading to Team Edition 3.0.x from 2.x

You need to migrate your database before upgrading mattermost to 3.0.x from 2.x. Run these commands in the latest mattermost-docker directory.

docker-compose rm -f app
docker-compose build app
docker-compose run app -upgrade_db_30
docker-compose up -d

See the offical Upgrade Guide for more details.

Known Issues

  • Do not modify the Listen Address in Service Settings.
  • Rarely 'app' container fails to start because of "connection refused" to database. Workaround: Restart the container.

More informations

If you want to know how to use docker-compose, see the overview page.

If you want to run Mattermost on Kubernetes you can start with the manifest examples in the kubernetes folder

For the server configurations, see prod-ubuntu.rst of mattermost.