Chạy Mattermost trong Docker: compose, PostgreSQL và khởi tạo workspace

Mattermost là nền tảng cộng tác self-hosted. Các bước dưới đây đi theo đúng trình tự cài đặt; hãy thay password mẫu bằng mật khẩu riêng.¹

1. Cài Docker trên Linux

Bước 1/12: Đăng nhập thiết bị Linux.

Bước 2/12: Chạy prerequisites và cài Docker:

# install prerequisites
sudo apt install apt-transport-https ca-certificates git curl software-properties-common gnupg-agent -y
# add docker gpg key
curl -fsSL https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release)/gpg | sudo apt-key add -
# add docker software repository
sudo add-apt-repository "deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release) $(lsb_release -cs) stable"
# install docker
sudo apt install docker-ce docker-compose containerd.io -y
# enable and start docker service
sudo systemctl enable docker && sudo systemctl start docker
# add the current user to the docker group
sudo usermod -aG docker $USER
# reauthenticate for the new group membership to take effect
su - $USER

2. Tải repository và chuẩn bị `.env`

Bước 3/12: Sau khi có Docker, chạy các lệnh chuẩn bị Mattermost:

# clone git repo
git clone https://github.com/mattermost/docker ~/docker/mattermost
# create working directories
mkdir ~/docker/mattermost/{config,data,logs,plugins,client/plugins,bleve-indexes} -p
# create a copy of .env
cp ~/docker/mattermost/env.example ~/docker/mattermost/.env
# set owner of working directories
sudo chown "$USER":"$USER" ~/docker -R
# allow the container to write to working directories
sudo chmod a+rwx -R ~/docker/mattermost
# replace default paths
sudo sed -i "s|/volumes||" ~/docker/mattermost/.env
# edit .env
nano ~/docker/mattermost/.env

Bước 4/12: Sửa tối thiểu các biến sau trong .env:

DOMAIN=ubuntuserver.local
TZ=America/New_York
POSTGRES_USER=mattermost_rw
POSTGRES_PASSWORD=[REDACTED]

DOMAIN, timezone và database password là ví dụ từ source; thay domain/zone và tạo password mới ở máy local.

Bước 5/12: Nhấn CTRL+O, Enter, CTRL+X để ghi thay đổi vào .env.

3. Khởi động Mattermost

Bước 6/12: Chạy compose từ thư mục Mattermost:

# cd to matter most directory
cd ~/docker/mattermost
# run mattermost container
sudo docker compose -f docker-compose.yml -f docker-compose.without-nginx.yml up -d

Bước 7/12: Mở trình duyệt tới:

http://DNSorIP:8065

Thay DNSorIP bằng địa chỉ của host, không đưa dịch vụ ra Internet mà không có TLS/authentication.

Bước 8/12: Bấm nút View in Browser.

Bước 9/12: Hoàn tất form để tạo account.

Bước 10/12: Nhập Organization Name, rồi bấm Continue.

Bước 11/12: Hoàn tất các prompt còn lại hoặc chọn bỏ qua.

Bước 12/12: Trang chào mừng Mattermost chạy trong Docker xuất hiện.

4. Kiểm tra sau wizard

cd ~/docker/mattermost
sudo docker compose -f docker-compose.yml -f docker-compose.without-nginx.yml ps
sudo docker compose -f docker-compose.yml -f docker-compose.without-nginx.yml logs --tail=100

Backup các thư mục config, data, logs, plugins, client/plugins, bleve-indexes và .env ngoài Git. Source cũng liên kết tài liệu cài Docker chính thức của Mattermost; đọc lại tài liệu đó khi image/compose file thay đổi.¹

Kết luận

Mười hai bước của tutorial đi theo đường ngắn: cài Docker, clone repository, tạo volume, sửa bốn biến .env, chạy compose không Nginx rồi hoàn tất wizard ở cổng 8065. Password thật chỉ tồn tại trong secret storage local; reverse proxy, TLS, backup và cập nhật image cần được bổ sung trước khi dùng production.

Nguồn

i12bretro tutorial 0889 – Mattermost - Secure Collaboration Platform - in Docker , revised 2025-01-14. ↩︎ ↩︎