Mattermost

Key Features

• Real-time messaging with WebSocket connections supporting unlimited message history and file attachments up to configurable size limits
• Advanced search functionality powered by PostgreSQL's full-text search capabilities with message indexing and ranking
• Extensive plugin ecosystem with over 100 integrations including GitHub, GitLab, Jira, Jenkins, and custom webhook support
• Built-in Playbooks feature for incident response and process automation with customizable workflows and checklists
• Integrated Kanban boards for project management with card-based organization and team collaboration
• Voice and video calling capabilities through the included Calls plugin with screen sharing and recording options
• Multi-team architecture allowing single Mattermost instance to host multiple isolated team workspaces
• LDAP/SAML integration support with PostgreSQL storing authentication mappings and user session management

Common Use Cases

• 1Software development teams needing integrated chat with code repositories, CI/CD pipelines, and issue tracking systems
• 2Healthcare organizations requiring HIPAA-compliant messaging with full data control and audit trails
• 3Financial institutions needing secure internal communications with compliance reporting and data retention policies
• 4Remote-first companies building comprehensive digital workspaces with persistent chat history and searchable knowledge bases
• 5DevOps teams coordinating incident response through automated playbooks and integrated monitoring alerts
• 6Educational institutions providing secure student and faculty collaboration platforms with controlled access
• 7Government agencies requiring on-premises messaging solutions with stringent security and data sovereignty requirements

Prerequisites

• Docker host with minimum 2GB RAM (4GB+ recommended for teams over 50 users) to support Mattermost and PostgreSQL memory requirements
• Available port 8065 for Mattermost web interface access and API endpoints
• Basic understanding of environment variable configuration for database connection strings and authentication settings
• SSL certificate and reverse proxy knowledge for production deployments requiring HTTPS and custom domains
• PostgreSQL administration familiarity for backup procedures, performance tuning, and database maintenance tasks
• Network configuration knowledge for firewall rules, especially if integrating with external services like LDAP or SAML providers

docker-compose.yml

1services: 
2  mattermost: 
3    image: mattermost/mattermost-team-edition:latest
4    container_name: mattermost
5    restart: unless-stopped
6    environment: 
7      MM_SQLSETTINGS_DRIVERNAME: postgres
8      MM_SQLSETTINGS_DATASOURCE: postgres://${DB_USER}:${DB_PASSWORD}@postgres:5432/${DB_NAME}?sslmode=disable
9    volumes: 
10      - mattermost_data:/mattermost/data
11      - mattermost_logs:/mattermost/logs
12      - mattermost_config:/mattermost/config
13      - mattermost_plugins:/mattermost/plugins
14    ports: 
15      - "8065:8065"
16    depends_on: 
17      - postgres
18    networks: 
19      - mattermost
20
21  postgres: 
22    image: postgres:16-alpine
23    container_name: mattermost-postgres
24    environment: 
25      POSTGRES_DB: ${DB_NAME}
26      POSTGRES_USER: ${DB_USER}
27      POSTGRES_PASSWORD: ${DB_PASSWORD}
28    volumes: 
29      - postgres_data:/var/lib/postgresql/data
30    networks: 
31      - mattermost
32
33volumes: 
34  mattermost_data: 
35  mattermost_logs: 
36  mattermost_config: 
37  mattermost_plugins: 
38  postgres_data: 
39
40networks: 
41  mattermost: 
42    driver: bridge

.env Template

1DB_NAME=mattermost
2DB_USER=mattermost
3DB_PASSWORD=changeme

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

mattermost:
  image: mattermost/mattermost-team-edition:latest
  container_name: mattermost
  restart: unless-stopped
  environment:
    MM_SQLSETTINGS_DRIVERNAME: postgres
    MM_SQLSETTINGS_DATASOURCE: postgres://${DB_USER}:${DB_PASSWORD}@postgres:5432/${DB_NAME}?sslmode=disable
  volumes:
    - mattermost_data:/mattermost/data
    - mattermost_logs:/mattermost/logs
    - mattermost_config:/mattermost/config
    - mattermost_plugins:/mattermost/plugins
  ports:
    - "8065:8065"
  depends_on:
    - postgres
  networks:
    - mattermost

postgres:
  image: postgres:16-alpine
  container_name: mattermost-postgres
  environment:
    POSTGRES_DB: ${DB_NAME}
    POSTGRES_USER: ${DB_USER}
    POSTGRES_PASSWORD: ${DB_PASSWORD}
  volumes:
    - postgres_data:/var/lib/postgresql/data
  networks:
    - mattermost

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  mattermost:
5    image: mattermost/mattermost-team-edition:latest
6    container_name: mattermost
7    restart: unless-stopped
8    environment:
9      MM_SQLSETTINGS_DRIVERNAME: postgres
10      MM_SQLSETTINGS_DATASOURCE: postgres://${DB_USER}:${DB_PASSWORD}@postgres:5432/${DB_NAME}?sslmode=disable
11    volumes:
12      - mattermost_data:/mattermost/data
13      - mattermost_logs:/mattermost/logs
14      - mattermost_config:/mattermost/config
15      - mattermost_plugins:/mattermost/plugins
16    ports:
17      - "8065:8065"
18    depends_on:
19      - postgres
20    networks:
21      - mattermost
22
23  postgres:
24    image: postgres:16-alpine
25    container_name: mattermost-postgres
26    environment:
27      POSTGRES_DB: ${DB_NAME}
28      POSTGRES_USER: ${DB_USER}
29      POSTGRES_PASSWORD: ${DB_PASSWORD}
30    volumes:
31      - postgres_data:/var/lib/postgresql/data
32    networks:
33      - mattermost
34
35volumes:
36  mattermost_data:
37  mattermost_logs:
38  mattermost_config:
39  mattermost_plugins:
40  postgres_data:
41
42networks:
43  mattermost:
44    driver: bridge
45EOF
46
47# 2. Create the .env file
48cat > .env << 'EOF'
49DB_NAME=mattermost
50DB_USER=mattermost
51DB_PASSWORD=changeme
52EOF
53
54# 3. Start the services
55docker compose up -d
56
57# 4. View logs
58docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/mattermost/run | bash

Troubleshooting