Install MySQL database server#

Install and set up the database for use by the Mattermost server. You can install either MySQL or PostgreSQL.

Install MySQL on Ubuntu Server 20.04#

  1. Log into the server that will host the database, and open a terminal window.

  2. Install MySQL.

sudo apt install mysql-server

  1. Run sudo mysql_secure_installation and follow the instructions.

  2. Log in to MySQL as root.

sudo mysql

  1. Create the Mattermost user mmuser.

mysql> create user 'mmuser'@'%' identified by 'mmuser-password';

Note

  1. Use a password that is more secure than ‘mmuser-password’.

  2. The ‘%’ means that mmuser can connect from any machine on the network. However, it’s more secure to use the IP address of the machine that hosts Mattermost. For example, if you install Mattermost on the machine with IP address 10.10.10.2, then use the following command: mysql> create user 'mmuser'@'10.10.10.2' identified by 'mmuser-password';

  1. Create the Mattermost database.

mysql> create database mattermost;

  1. Grant access privileges to the user mmuser.

mysql> grant all privileges on mattermost.* to 'mmuser'@'%';

Note

This query grants the MySQL user we just created all privileges on the database for convenience. If you need more security you can use this query to grant the user only the privileges necessary to run Mattermost.

mysql> GRANT ALTER, CREATE, DELETE, DROP, INDEX, INSERT, SELECT, UPDATE, REFERENCES ON mattermost.* TO 'mmuser'@'%';

  1. Log out of MySQL.

    mysql> exit

With the database installed and the initial setup complete, you can now install the Mattermost server.