by mozilla


Deploy Mattermost Team or Enterprise Edition to Heroku


This buildpack is an inline buildpack (tldr: this repo deploys to Heroku and uses itself as a buildpack) for deploying Mattermost to Heroku. It must used in tandem with This customized Nginx Buildpack.

Mattermost is not a 12 factor compatible app, so the startup script writes your Heroku environment variables to a config file when the dyno starts.

Known to work with Mattermost 3.4.0 Team and Enterprise editions

Configuration options

Buildpack Specific Variables

Set MATTERMOST_VERSION to the release version you'd like to install. i.e. '3.4.0' Set MATTERMOST_TYPE to either 'team' or 'enterprise'

Mattermost Configuration

Mattermost-Heroku supports every config option that Mattermost 3.4 defines. You can see the mapping between Mattermost config settings and Heroku environment variables in the configuration template.

Check out the Mattermost configuration documentation for detailed information about each option.


Use the deploy menu on the Heroku dashboard to trigger manual deploys.


  1. Don't make configuration changes in the Mattermost admin console. Any configuration changes in the Mattermost admin console will likely be lost on dyno restart (which may be every 24 hours) and will likely not be distributed across multiple dynos.
  2. Not using s3 means any uploads will be lost on dyno restart or application reconfiguration or redeploy and won't be consistent across multiple dynos. Without s3 backing this is not anything more than a one time demo.

Enterprise Edition

Activate it as instructed in the docs