tjtoml.mattermost

This is an Ansible role for installing Mattermost, an open-source alternative to Slack. By default, this playbook will install Mattermost version 4.3.2 (Team Edition).

It downloads the software from mattermost.org. If you want the Enterprise edition, please check the Mattermost documentation.

Supported Systems

This role works with:

Ubuntu 14.04.5 LTS (Trusty Tahr)
Ubuntu 16.04.3 LTS (Xenial Xerus)
CentOS 6.9
CentOS 7.4
Red Hat Enterprise Linux 6.9
Red Hat Enterprise Linux 7.4
Debian 7.11 Wheezy
Debian 8.9 Jessie
Debian 9.2 Stretch

It should also work with other cloud providers, but I tested it on DigitalOcean.

Requirements

A fully qualified domain name (FQDN) set up (e.g., mattermost.example.com).
If using Let's Encrypt, you must configure reverse DNS. You can check it here.
Internet access.

Role Variables

You can set various configurations in Mattermost's config.json file. Here are some common variables to set:

mattermost_version: 4.3.2
db_user: mmost
db_name: mattermost
db_password: notReallyASecurePassword
cert_email_address: abc@123.com
mattermost_user: mattermost
SSL_type: letsencrypt # Options: letsencrypt, snakeoil, nossl

For more variables and defaults, see defaults/main.yml.

Dependencies

To install required roles, run:

ansible-galaxy install -r requirements.yml

Required Roles:

tjtoml.nginx
tjtoml.postgresql
tjtoml.letsencrypt

Example Playbook

Here’s a sample playbook:

---
- hosts: all
  remote_user: root
  gather_facts: no
  pre_tasks:
    - name: Install Python (needed for Ubuntu 16 and up; safe for other distros)
      raw: test -e /usr/bin/python || (apt -y update && apt install -y python-minimal)
      changed_when: false
    - name: Gather Facts
      setup:
  roles:
    - { role: tjtoml.mattermost }
  vars:
    mattermost_version: 4.3.2
    db_user: mmost
    db_name: mattermost
    db_password: notReallyASecurePassword
    cert_email_address: [email protected]
    mattermost_user: mattermost
    SSL_type: nossl