はじめに

Mattermost をオンプレで構築してみました。備忘録に

📌 構築環境

OS: Ubuntu 24.04.2 LTS
Docker（Docker Engine / Docker Compose）インストール済み
OpenSSH インストール済み

Mattermost の Docker 構成を GitHub からクローンする

Mattermost 公式が Docker ベースの構築用リポジトリを公開しています。

git clone https://github.com/mattermost/docker

完了すると docker/ ディレクトリが作成されます。

.env ファイルを作成する

docker/ ディレクトリ内に env.example があるので、これを .env としてコピーします。

cp env.example .env

この .env に Mattermost のバージョン・DBの設定・TLS設定などが読み込まれるため、必要に応じて編集してください。

同梱の NGINX を使って TLS（HTTPS）対応させる

Mattermost の Docker 構成には NGINX のコンテナが含まれており、HTTPS で公開できます。

設定を変更する場合は nginx/ ディレクトリ内を編集します。

例：ポート番号を変えたい場合

nginx/conf.d/mattermost.conf を編集して listen ポートを変更できます。

また、自己署名証明書や Let's Encrypt を使いたい場合は nginx/ssl 配下に配置すればOKです。
今回は step-ca を使って証明書を発行しています。

Docker Compose で起動する

cd ~/mattermost-docker

初回起動はイメージを pull して DB 構築まで入るため少し時間がかかります。
mattermostと同時にnginxも立ち上げます。

docker compose -f docker-compose.yml -f docker-compose.nginx.yml up -d

状態を確認：

docker ps

app、db、nginx などのコンテナが Up になっていればOKです。

ブラウザからアクセスして初期設定

https://<サーバのIPまたはFQDN>/

へアクセスします。

初回アクセスで管理者アカウントを作成し、チーム名や基本設定を行います。

よくあるつまずきポイント

443ポートが既に使われていた

NGINX が起動しない場合は以下でポート競合を確認します：

sudo lsof -i :443

TLS証明書の読み込みエラー

証明書ファイルのパーミッションは以下推奨：

chmod 600 nginx/ssl/*.key

自己署名 TLS 証明書を作成する（必要な場合）

社内ネットワークのみで利用する場合など、外部の認証局を使わずに自己署名証明書（Self-signed certificate）を作成して NGINX に設定することもできます。

以下は nginx/ssl/ に証明書を配置する例です。

証明書用のディレクトリを作成

mkdir -p nginx/ssl
cd nginx/ssl

OpenSSL で自己署名証明書を作成（有効期限365日）

openssl req -x509 -nodes -newkey rsa:2048 \
  -keyout mattermost.key \
  -out mattermost.crt \
  -days 365

コマンド実行中に以下の項目を聞かれますが、必要最低限でOKです。

Country Name (2 letter code) [AU]: JP
State or Province Name (full name) []: Tokyo
Locality Name (eg, city) []: Chiyoda
Organization Name (eg, company) []: MyCompany
Organizational Unit Name (eg, section) []: IT
Common Name (e.g. server FQDN or YOUR name) []: mattermost.local  ←重要
Email Address []:

※ Common Name（CN）にはアクセス時に使用する FQDN または IP アドレスを必ず指定してください

パーミッションの調整（NGINX エラー防止）

chmod 600 mattermost.key
chmod 644 mattermost.crt

NGINX の設定に証明書を反映

nginx/conf.d/mattermost.conf を編集します。

ssl_certificate     /etc/nginx/ssl/mattermost.crt;
ssl_certificate_key /etc/nginx/ssl/mattermost.key;

Docker では nginx/ssl ディレクトリが /etc/nginx/ssl にそのままマウントされるため、このパスで問題ありません。

NGINX を再起動

docker compose restart nginx

これで自己署名証明書を使った HTTPS アクセスが可能になります。
（ブラウザでは「安全でない証明書」と表示されますが、社内用途なら問題ありません）

step-caを使用した場合はルート証明書を各クライアントにインストールしましょう。