{"id":9630,"date":"2021-08-28T03:32:55","date_gmt":"2021-08-28T03:32:55","guid":{"rendered":"https:\/\/linuxways.net\/?p=9630"},"modified":"2021-09-01T17:45:19","modified_gmt":"2021-09-01T17:45:19","slug":"how-to-deploy-mattermost-on-ubuntu-20-04","status":"publish","type":"post","link":"https:\/\/linuxways.net\/de\/ubuntu\/how-to-deploy-mattermost-on-ubuntu-20-04\/","title":{"rendered":"How to Deploy Mattermost on Ubuntu 20.04"},"content":{"rendered":"

Introduction<\/h2>\n

Mattermost is a self-hosted and open-source online chat. It is developed as a private conversation for organizations and companies.<\/p>\n

It’s a tool with features like Slack and Microsoft Teams. And Mattermost is often installed with PostgreSQL database server.<\/p>\n

Below is the guide on how to deploy Mattermost on Ubuntu 20.04 as we go through below.<\/p>\n

Step 1 – Update system<\/h2>\n

Run apt command:<\/p>\n

$ sudo apt update<\/pre>\n
Then run the command:<\/p>\n
$ sudo apt upgrade<\/pre>\n
Output: <\/p>\n
Lastly, set proper server hostname:<\/p>\n
$ sudo hostnamectl set-hostname NEW_HOSTNAME --static<\/pre>\n
Here, we set a hostname named \u201cchat.ubuntu<\/strong>\u201d<\/p>\n
$ sudo hostnamectl set-hostname chat.ubuntu --static<\/pre>\n
Step 2 – Install PostgreSQL Database Server<\/h2>\n
Run the apt command to install:<\/p>\n
$ sudo apt install postgresql postgresql-contrib<\/pre>\n
Output:<\/p>\n
<\/p>\n
Then login to the postgres account:<\/p>\n
$ sudo --login --user postgres<\/pre>\n
<\/p>\n
Start the PostgeSQL on the terminal and create the Mattermost database\/user. Here I named it \u201clinuxer<\/strong>\u201d with the password \u201clinuxer@123<\/strong>\u201d<\/p>\n
psql<\/pre>\n
CREATE DATABASE mattermost;<\/pre>\n
CREATE USER linuxer WITH PASSWORD 'linuxer@123';<\/pre>\n
GRANT ALL PRIVILEGES ON DATABASE mattermost to linuxer;<\/pre>\n
\\q<\/pre>\n
<\/p>\n
Step 3 – Create Mattermost system user and group<\/h2>\n
We will create a system user and group named \u201cmattermost<\/strong>\u201d:<\/p>\n
$ sudo useradd --system --user-group mattermost<\/pre>\n
You can confirm by the command:<\/p>\n
$ id mattermost<\/pre>\n
Output:<\/p>\n
<\/p>\n
Step 4 – Install Mattermost<\/h2>\n
Firstly, you must create a folder named \u201cmattermost<\/strong>\u201d<\/p>\n
$ mkdir mattermost<\/pre>\n
Then navigate to it:<\/p>\n
$ cd mattermost<\/pre>\n
Run the wget command to download Mattermost:<\/p>\n
$ wget https:\/\/releases.mattermost.com\/5.38.1\/mattermost-5.38.1-linux-amd64.tar.gz<\/pre>\n
Output:<\/p>\n
<\/p>\n
Extract the package:<\/p>\n
$ tar -xvzf mattermost*.gz<\/pre>\n
Copy the extracted file to \/otp directory:<\/p>\n
$ sudo cp -r mattermost \/opt<\/pre>\n
Create a folder for Mattermost to contain user data:<\/p>\n
$ sudo mkdir \/opt\/mattermost\/data<\/pre>\n
Set correct ownership and permissions:<\/p>\n
$ sudo chown -R mattermost:mattermost \/opt\/mattermost<\/pre>\n
Finally, let\u2019s grant write permission to \/opt\/mattermost directory:<\/p>\n
$ sudo chmod -R g+w \/opt\/mattermost<\/pre>\n
Step 5 – Configure Mattermost Server<\/h2>\n
Config setting in the file \/opt\/mattermost\/config\/config.json<\/p>\n
$ sudo nano \/opt\/mattermost\/config\/config.json<\/pre>\n
Then configure PostgreSQL database settings: <\/p>\n
After the text editor is opened, press Ctrl + W and search \u201cDriverName<\/strong>\u201d <\/p>\n
Change the line in red part:<\/p>\n
\"postgres:\/\/matteruser:password@localhost:5432\/mattermost?sslmode=disable&connect_timeout=10\",<\/pre>\n
<\/p>\n
Save it.<\/p>\n
Step 6 – Configure Systemd Service<\/h2>\n
Create Mattermost Systemd:<\/p>\n
$ sudo vim \/etc\/systemd\/system\/mattermost.service<\/pre>\n
Type the lines below:<\/p>\n
[Unit]\r\n\r\nDescription=Mattermost\r\n\r\nAfter=network.target\r\n\r\nAfter=postgresql.service\r\n\r\nRequires=postgresql.service\r\n\r\n[Service]\r\n\r\nType=notify\r\n\r\nExecStart=\/opt\/mattermost\/bin\/mattermost\r\n\r\nTimeoutStartSec=3600\r\n\r\nRestart=always\r\n\r\nRestartSec=10\r\n\r\nWorkingDirectory=\/opt\/mattermost\r\n\r\nUser=mattermost\r\n\r\nGroup=mattermost\r\n\r\nLimitNOFILE=49152\r\n\r\n[Install]\r\n\r\nWantedBy=multi-user.target<\/pre>\n
<\/p>\n
Press ESC + :wq to save.<\/p>\n
Load the new unit into systemd:<\/p>\n
$ sudo systemctl daemon-reload<\/pre>\n
Confirm service running status:<\/p>\n
$ systemctl status mattermost.service<\/pre>\n
Output: <\/p>\n
Enable mattermost service:<\/p>\n
$ sudo systemctl enable mattermost.service<\/pre>\n
Step 7 – Install Nginx<\/h2>\n
$ sudo apt -y install nginx<\/pre>\n
<\/p>\n
You need to type your domain in the Mattermost configuration file:<\/p>\n
$ sudo nano \/opt\/mattermost\/config\/config.json<\/pre>\n
<\/p>\n
Save it.<\/p>\n
Open the text editor to config able to access your domain:<\/p>\n
$ sudo nano \/etc\/nginx\/sites-available\/mattermost.conf<\/pre>\n
Add the lines below:<\/p>\n
upstream backend {\r\n\r\nserver localhost:8065;\r\n\r\nkeepalive 32;\r\n\r\n}\r\n\r\nproxy_cache_path \/var\/cache\/nginx levels=1:2 keys_zone=mattermost_cache:10m max_size=3g inactive=120m use_temp_path=off;\r\n\r\nserver {\r\n\r\nlisten 80;\r\n\r\nserver_name your domain;\r\n\r\nlocation ~ \/api\/v[0-9]+\/(users\/)?websocket$ {\r\n\r\nproxy_set_header Upgrade $http_upgrade;\r\n\r\nproxy_set_header Connection \"upgrade\";\r\n\r\nclient_max_body_size 50M;\r\n\r\nproxy_set_header Host $http_host;\r\n\r\nproxy_set_header X-Real-IP $remote_addr;\r\n\r\nproxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\r\n\r\nproxy_set_header X-Forwarded-Proto $scheme;\r\n\r\nproxy_set_header X-Frame-Options SAMEORIGIN;\r\n\r\nproxy_buffers 256 16k;\r\n\r\nproxy_buffer_size 16k;\r\n\r\nclient_body_timeout 60;\r\n\r\nsend_timeout 300;\r\n\r\nlingering_timeout 5;\r\n\r\nproxy_connect_timeout 90;\r\n\r\nproxy_send_timeout 300;\r\n\r\nproxy_read_timeout 90s;\r\n\r\nproxy_pass http:\/\/backend;\r\n\r\n}\r\n\r\nlocation \/ {\r\n\r\nclient_max_body_size 50M;\r\n\r\nproxy_set_header Connection \"\";\r\n\r\nproxy_set_header Host $http_host;\r\n\r\nproxy_set_header X-Real-IP $remote_addr;\r\n\r\nproxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\r\n\r\nproxy_set_header X-Forwarded-Proto $scheme;\r\n\r\nproxy_set_header X-Frame-Options SAMEORIGIN;\r\n\r\nproxy_buffers 256 16k;\r\n\r\nproxy_buffer_size 16k;\r\n\r\nproxy_read_timeout 600s;\r\n\r\nproxy_cache mattermost_cache;\r\n\r\nproxy_cache_revalidate on;\r\n\r\nproxy_cache_min_uses 2;\r\n\r\nproxy_cache_use_stale timeout;\r\n\r\nproxy_cache_lock on;\r\n\r\nproxy_http_version 1.1;\r\n\r\nproxy_pass http:\/\/backend;\r\n\r\n}\r\n\r\n}\r\n\r\n<\/pre>\n
Save it.<\/p>\n
To make this site configuration work, you must create a softlink for it in the folder \/etc\/nginx\/sites-enabled:<\/p>\n
$ sudo ln -s \/etc\/nginx\/sites-available\/mattermost.conf \/etc\/nginx\/sites-enabled\/mattermost.conf<\/pre>\n
Run this command to check the validity of the configuration:<\/p>\n
$ sudo nginx -t<\/pre>\n
Output: <\/p>\n
Restart Nginx:<\/p>\n
$ sudo systemctl restart nginx<\/pre>\n
Then start mattermost service:<\/p>\n
$ sudo systemctl start mattermost<\/pre>\n
You can try to access your domain.<\/p>\n
Conclusion<\/h2>\n
You\u2019ve already gone through the details of how to deploy Mattermost on Ubuntu 20.04.Thanks for reading.<\/p>","protected":false},"excerpt":{"rendered":"
Introduction Mattermost is a self-hosted and open-source online chat. It is developed as a private conversation for organizations and companies. It’s a tool with features like Slack and…<\/p>","protected":false},"author":1,"featured_media":9762,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[509,100],"class_list":["post-9630","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ubuntu","tag-mattermost","tag-ubuntu-20-04"],"_links":{"self":[{"href":"https:\/\/linuxways.net\/de\/wp-json\/wp\/v2\/posts\/9630","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/linuxways.net\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/linuxways.net\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/linuxways.net\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/linuxways.net\/de\/wp-json\/wp\/v2\/comments?post=9630"}],"version-history":[{"count":2,"href":"https:\/\/linuxways.net\/de\/wp-json\/wp\/v2\/posts\/9630\/revisions"}],"predecessor-version":[{"id":9761,"href":"https:\/\/linuxways.net\/de\/wp-json\/wp\/v2\/posts\/9630\/revisions\/9761"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/linuxways.net\/de\/wp-json\/wp\/v2\/media\/9762"}],"wp:attachment":[{"href":"https:\/\/linuxways.net\/de\/wp-json\/wp\/v2\/media?parent=9630"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/linuxways.net\/de\/wp-json\/wp\/v2\/categories?post=9630"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/linuxways.net\/de\/wp-json\/wp\/v2\/tags?post=9630"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}