# Установка Mattermost на Ubuntu
**Mattermost** — это платформа для обмена сообщениями и совместной работы, которую можно установить на собственных серверах или в облаке. Mattermost является альтернативой таким мессенджерам как [Slack](https://slack.com/) и [RocketChat](https://www.rocket.chat/).
В этом гайде мы рассмотрим тарифный план Free, который включает в себя безлимитную историю сообщений и групповые звонки ([подробнее о тарифах](https://mattermost.com/pricing/)). Клиенты Mattemost доступны на мобильных платформах (IOS, Android), в десктоп-версиях (Windows, Linux, Mac), также поддерживается браузерная версия.
> Для тарифа Free доступна только Self Hosted версия; далее будет разбираться установка на Ubuntu. Ознакомиться с другими способами установки (в том числе и Docker-образ) можно на [официальном сайте](https://mattermost.com/download/).
### Технические требования
На 1000 пользователей минимально потребуется 1 CPU, 2GB RAM и PostgreSQL v11+ (необязательно использовать именно Postgres).
### Установка Mattermost
Теперь можно переходить к самой установке. Для установки подключим репозиторий `deb.packages.mattermost.com/repo-setup.sh`.
```
curl -o- https://deb.packages.mattermost.com/repo-setup.sh | sudo bash -s mattermost
```
Здесь в `sudo bash -s mattermost` передается аргумент `mattermost` для добавления репозитория только Mattermost. Аргументом по умолчанию в данном скрипте является `all`, тогда будут также добавлены репозитории Ngnix, PostgreSQL и Certbot.
Установим сервис. Он будет установлен по пути `/opt/mattermost`. Пользователь `mattermost` и группа `mattermost` будут созданы автоматически.
```
sudo apt update
sudo apt install mattermost -y
```
После установки понадобится создать `config.json` с необходимыми правами (он создается на основе `config.defaults.json`). Чтение и запись в файл будут доступны только для пользователя владельца (в нашем случае это `mattermost`).
```
sudo install -C -m 600 -o mattermost -g mattermost /opt/mattermost/config/config.defaults.json /opt/mattermost/config/config.json
```
В конфиге необходимо заполнить параметры:
```
sudo nano /opt/mattermost/config/config.json
```
- SiteUrl — сюда необходимо прописать созданный домен с протоколом https (в блоке `ServiceSettings`). Позже мы подключим SSL-сертификат.
- DriverName — по умолчанию стоит postgres (в блоке `SqlSettings`).
- DataSource — указать пользователя, пароль, хост и имя БД в ссылке подключения (в блоке `SqlSettings`).
Остальные конфиги не важны для первого запуска, и их можно будет изменить позднее в административной консоли Mattermost.
Запускаем сервис Mattermost:
```
sudo systemctl start mattermost
```
Проверим, что ничего не упало и Mattermost поднялся:
```
sudo systemctl status mattermost.service
```
Если сайт не открывается, проверьте настройки фаервола. Также можно обратиться к порту локально с сервера:
```
curl -v localhost:8065
```
Дополнительно добавим автозапуск сервиса:
```
sudo systemctl enable mattermost.service
```
#### Nginx
Мы не будем напрямую использовать порт 8065 — он будет позже закрыт фаерволом. Для проксирования запросов установим Nginx.
```
sudo apt install nginx
```
Теперь добавим конфигурацию:
```
sudo nano /etc/nginx/sites-available/mattermost
```
В строке `server_name` необходимо указать свой домен, в нашем случае *mattermost.twc1.net*.
Обратите внимание, что проксируется как HTTP, так и websocket-протоколы.
```
upstream backend {
server 127.0.0.1:8065;
keepalive 32;
}
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=mattermost_cache:10m max_size=3g inactive=120m use_temp_path=off;
server {
listen 80;
server_name mattermost.twc1.net;
location ~ /api/v[0-9]+/(users/)?websocket$ {
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
client_max_body_size 50M;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Frame-Options SAMEORIGIN;
proxy_buffers 256 16k;
proxy_buffer_size 16k;
client_body_timeout 60;
send_timeout 300;
lingering_timeout 5;
proxy_connect_timeout 90;
proxy_send_timeout 300;
proxy_read_timeout 90s;
proxy_pass http://backend;
}
location / {
client_max_body_size 50M;
proxy_set_header Connection "";
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Frame-Options SAMEORIGIN;
proxy_buffers 256 16k;
proxy_buffer_size 16k;
proxy_read_timeout 600s;
proxy_cache mattermost_cache;
proxy_cache_revalidate on;
proxy_cache_min_uses 2;
proxy_cache_use_stale timeout;
proxy_cache_lock on;
proxy_http_version 1.1;
proxy_pass http://backend;
}
}
```
Добавим линк конфигурационного файла в `sites-enabled`:
```
sudo ln -s /etc/nginx/sites-available/mattermost /etc/nginx/sites-enabled/mattermost
```
Уберем дефолтный конфиг:
```
sudo rm -f /etc/nginx/sites-enabled/default
```
Делаем рестарт сервиса Nginx:
```
sudo service nginx restart
```
Теперь выпустим сертификат от Let’s Encrypt для домена через `certbot`:
```
sudo apt install python3-certbot-nginx && certbot
```
Certbot попросит указать почту, домен и после добавит сертификат для домена.
После установки сертификата `certbot` допишет конфигурацию nginx mattermost. Будет добавлена директива `listen` для обработки запросов с 443 порта, директивы с ключами и конфигами для SSL, а также редирект с HTTP на HTTPS.
#### Firewall
Я ограничил входящие TCP запросы портами 22 для работы с SSH, 80 и 443 для TCP. Для сбора метрик на дашборд сервера необходимо открыть также порт 10050; список IP-адресов, для которых необходимо открывать порт, будет в `/etc/zabbix/zabbix_agentd.conf`.
### Первый запуск
Теперь Mattermost будет доступен по адресу https://mattermost.twc1.net/*.*
Из коробки будут доступны звонки, playbooks, магазин с плагинами, аутентификация Gitlab. Также сам продукт имеет [отличную документацию](https://docs.mattermost.com/).
[Источник](https://timeweb.cloud/tutorials/servers/ustanovka-mattermost-na-ubuntu)