사용 가능 에디션: Free, Professional, Enterprise, Enterprise Advanced

사용 가능 배포 방식: 셀프 호스팅

Red Hat Enterprise Linux(RHEL) 9 이상 또는 Rocky Linux, AlmaLinux, Oracle Linux, CentOS Stream 9 이상과 같은 호환 배포판에 Mattermost 서버를 설치합니다. RHEL에는 서명된 APT 방식의 리포지터리가 없으므로, 이 가이드는 릴리즈 tarball에서 설치하고 systemd를 수동으로 설정한 다음, RHEL 배포에 일반적으로 필요한 보안 구성(SELinux 컨텍스트, firewalld 규칙, fapolicyd 허용 규칙)을 안내합니다.

1단계: PostgreSQL 데이터베이스 확보#

다음 중 하나를 선택하세요.

• 동일한 호스트에 PostgreSQL을 로컬로 설치합니다. PostgreSQL 설치 문서를 참조하세요.
• 외부 PostgreSQL 서버를 사용하고 2단계 전에 연결 자격 증명을 확보합니다.
• 관리형 데이터베이스 서비스를 사용합니다(AWS RDS, Azure Database for PostgreSQL 등).

2단계: 데이터베이스 준비#

데이터베이스 준비 지침에 따라 Mattermost 데이터베이스, 사용자, 권한을 생성합니다.

3단계: Mattermost 서버 tarball 다운로드#

대상 호스트에 SSH로 접속하여 릴리즈를 다운로드합니다. ARM 기반 하드웨어의 경우 amd64를 arm64로 교체하세요.

wget https://releases.mattermost.com/12.0.0/mattermost-12.0.0-linux-amd64.tar.gz

wget https://releases.mattermost.com/11.7.12/mattermost-11.7.12-linux-amd64.tar.gz

4단계: Mattermost 서버 설치#

먼저 기존 시스템 패키지를 업데이트합니다.

sudo dnf update
sudo dnf upgrade

tarball을 추출하고, 제자리로 이동한 다음, 소유권을 설정합니다.

tar -xvzf mattermost*.gz
sudo mv mattermost /opt
sudo mkdir /opt/mattermost/data
sudo useradd --system --user-group mattermost
sudo chown -R mattermost:mattermost /opt/mattermost
sudo chmod -R g+w /opt/mattermost

/etc/systemd/system/mattermost.service에 systemd 유닛 파일을 생성합니다.

[Unit]
Description=Mattermost
After=network.target

[Service]
Type=notify
ExecStart=/opt/mattermost/bin/mattermost
TimeoutStartSec=3600
KillMode=mixed
Restart=always
RestartSec=10
WorkingDirectory=/opt/mattermost
User=mattermost
Group=mattermost
LimitNOFILE=49152

[Install]
WantedBy=multi-user.target

systemd를 리로드합니다.

sudo systemctl daemon-reload

5단계: 서버 구성 및 시작#

편집하기 전에 기본 구성을 백업합니다.

sudo cp /opt/mattermost/config/config.json /opt/mattermost/config/config.defaults.json

/opt/mattermost/config/config.json을 편집하여 다음을 설정합니다.

• SqlSettings.DriverName: "postgres"
• SqlSettings.DataSource: "postgres://mmuser:<mmuser-password>@<host>:5432/mattermost?sslmode=disable&connect_timeout=10" — 각 플레이스홀더를 교체합니다.
• ServiceSettings.SiteURL: 배포의 공개 URL(예: https://mattermost.example.com).
• (권장) SupportSettings.SupportEmail: 사용자가 도움이 필요할 때 연락하는 이메일 주소.

서버를 시작합니다.

sudo systemctl start mattermost
curl http://localhost:8065

Mattermost HTML 응답이 표시되어야 합니다. 부팅 시 자동 시작되도록 활성화합니다.

sudo systemctl enable mattermost.service

강화된 RHEL 시스템에서 시작에 실패하면 다른 곳에서 문제를 해결하기 전에 아래의 강화된 RHEL 구성 섹션을 계속 진행하세요. 원인은 거의 항상 SELinux, firewalld 또는 fapolicyd입니다.

6단계: 서버 업데이트#

tarball 기반 설치는 수동으로 업그레이드합니다. Mattermost 서버 업그레이드를 참조하세요.

강화된 RHEL 구성#

강화된 RHEL 설치에는 일반적으로 SELinux, firewalld, fapolicyd에 대한 추가 구성이 필요합니다. 각각 아래에서 설명합니다.

sudo semanage fcontext -a -t bin_t "/opt/mattermost/bin(/.*)?"
sudo restorecon -RF /opt/mattermost/bin

ls -Z /opt/mattermost

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/mattermost(/.*)?"
sudo restorecon -R /opt/mattermost

sudo semanage port -l | grep 8065
sudo semanage port -a -t http_port_t -p tcp 8065

sudo ausearch -m avc -ts recent
sudo cat /var/log/audit/audit.log | grep denied

sudo yum install -y policycoreutils-python-utils
sudo grep mattermost /var/log/audit/audit.log | audit2allow -M mattermost_policy
sudo semodule -i mattermost_policy.pp

sudo systemctl restart mattermost

sudo systemctl status firewalld

sudo firewall-cmd --permanent --add-port=8065/tcp
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload
sudo firewall-cmd --list-all

# Integrated Calls plugin
sudo firewall-cmd --permanent --add-port=8443/udp
sudo firewall-cmd --permanent --add-port=8443/tcp
sudo firewall-cmd --reload

# Standalone rtcd (adds API port)
sudo firewall-cmd --permanent --add-port=8045/tcp
sudo firewall-cmd --reload

sudo systemctl stop fapolicyd
sudo systemctl start mattermost

sudo fapolicyd --debug

rule=15 dec=deny_audit perm=execute auid=-1 pid=19735
  exe=/opt/mattermost/bin/mattermost : path=/opt/mattermost/plugins/focalboard/server/dist/plugin-linux-amd64
  ftype=application/x-executable trust=0

allow perm=execute exe=/usr/bin/sudo trust=1 : dir=/opt/mattermost/ all trust=0
allow perm=execute exe=/opt/mattermost/bin/mattermost : dir=/opt/mattermost all trust=0
allow perm=execute exe=/usr/lib/systemd/systemd trust=1 : dir=/opt/mattermost/ all trust=0

sudo fagenrules --check
sudo fagenrules --load
sudo systemctl restart fapolicyd
sudo systemctl restart mattermost

curl http://localhost:8065
sudo systemctl status mattermost

allow perm=execute exe=/usr/bin/sudo trust=1 : dir=/opt/rtcd/ all trust=0
allow perm=execute exe=/opt/rtcd/bin/rtcd : dir=/opt/rtcd all trust=0
allow perm=execute exe=/usr/lib/systemd/systemd trust=1 : dir=/opt/rtcd/ all trust=0

Mattermost 제거#

서버를 중지하고 필요한 데이터를 백업한 다음, 설치 디렉터리를 제거합니다.

sudo systemctl stop mattermost
sudo rm -rf /opt/mattermost
sudo rm /lib/systemd/system/mattermost.service
sudo userdel mattermost

다음 단계#

• NGINX 리버스 프록시 설정
• TLS 설정