Chef cookbook for installing Mattermost open source, self-hosted Slack-alternative
Clone or download

Mattermost Cookbook

Build Status Cookbook Version


This cookbook installs and configures Mattermost, the opensource Slack alternative.

Supported Mattermost Versions

Mattermost Version Cookbook Version
5.4.0 v5.0.0
5.3.1 v4.0.1
5.2.1 v3.0.0
5.1.1 v2.1.1
5.0.1 v2.0.0
4.10.1 v1.6.10

For older versions see this cookbook history at Supermarket.



The following platforms and versions are tested and supported using test-kitchen

  • Ubuntu 16 LTS
  • Debian 9
  • CentOS 7


  • Chef 12.19+



Using this cookbook is relatively straightforward. It is recommended to create a project or organization specific wrapper cookbook and add the desired recipes (for example, to setup a database) to the run list of a node.


All settings are the default settings that come from Mattermost repository. Make sure to review them all and change what's necessary.

License and Authors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.