by Mattermost

VERSION 5.12.0

OS Ubuntu 18.04


The open source messaging platform for DevOps teams. Discuss topics in channels, private groups or one-to-one with rich Markdown formatting, and easily share code snippets with syntax highlighting for more than 50 programming languages. With this 1-Click App listing, you can deploy in moments and self-host team chat on your private cloud and connect in-house systems with plugins, Slack-compatible integrations, and extensive API support.

Software Included

Mattermost5.12.0Apache 2
Go1.12.5BSD-style[4] + patentgrant

Getting started after deploying Mattermost

Create the System Admin user and set up Mattermost for general use requires a few steps:

  1. Open a browser and navigate to your Mattermost instance on http://your_server_ip:8065
  2. Create the first team and user. The first user in the system has the system_admin role, which gives you access to the System Console.
  3. Open the System Console. To open the System Console, click your username at the top of the navigation panel, and in the menu that opens, click System Console.
  4. Set the Site URL:
  1. In the GENERAL section of the System Console, click Configuration.
  2. In the Site URL field, set the URL that users point their browsers at. For example, If you are using HTTPS, make sure that you set up TLS, either on Mattermost Server or on a proxy.
  1. Set up email notifications.
  1. In the NOTIFICATIONS section of the System Console, click Email and make the following changes:
  • Set Enable Email Notifications to true
  • Set Notification Display Name to No-Reply
  • Set Notification From Address to {your-domain-name} For example,
  • Set SMTP Server Username to {SMTP-username} For example,
  • Set SMTP Server Password to {SMTP-password}
  • Set SMTP Server to {SMTP-server} For example,
  • Set SMTP Server Port to 465
  • Set Connection Security to TLS or STARTTLS, depending on what the SMTP server accepts.
  1. Click Test Connection.
  2. After your connection is working, click Save.
  1. Set up the file and image storage location.


  1. Files and images that users attach to their messages are not stored in the database. Instead, they are stored in a location that you specify. You can store files on the local file system.
  2. Make sure that the location has enough free space. The amount of storage that’s required depends on the number of users and on the number and size of files users attach to messages.
  1. In the FILES section of the System Console, click Storage.
  2. If you store the files locally, set File Storage System to Local File System, and then either accept the default for the Local Storage Directory or enter a location. The location must be a directory that exists and has write permissions for the Mattermost server. It can be an absolute path or a relative path. Relative paths are relative to the mattermost directory.
  3. Click Save.
  1. Review the other settings in the System Console to make sure everything is as you want it.
  2. Restart the Mattermost Service.

sudo systemctl restart mattermost

API Creation

In addition to creating a Droplet from the Mattermost 1-Click App via the control panel, you can also use the DigitalOcean API.

As an example, to create a 4GB Mattermost Droplet in the SFO2 region, you can use the following curl command. You’ll need to either save your API access token to an environment variable or substitute it into the command below.

  curl -X POST -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer '$TOKEN'' -d \
      '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image":"mattermost-18-04"}' \

Support Details

Supported By:Mattermost
Support URL:

Learn More

Product Docs

Technical overviews, how-tos, release notes, and support material


DevOps and development guidelines

API Docs

Run your resources programmatically

Ask a question

Connect, share and learn