Tutoriales de VPS
Mattermost en VPS (2026): Docker, PostgreSQL, Caddy HTTPS y copias
Instale Mattermost 11.7 ESR en Ubuntu 24.04 con Docker Compose oficial, PostgreSQL y Caddy. Configure SMTP, push móvil y Calls, y pruebe copias, restauración y actualizaciones seguras.

Un chat de equipo parece ligero hasta que llega a producción. Lo difícil es que dominio, WebSocket, archivos, notificaciones móviles, llamadas y copias recuperables funcionen juntos.
Esta guía utiliza Ubuntu 24.04, Mattermost 11.7 ESR, el despliegue oficial Docker Compose, PostgreSQL y Caddy instalado en el host. Incluye HTTPS, primer administrador, SMTP, notificaciones móviles, Calls, copias, restauración y actualizaciones, con los límites de un VPS pequeño.
Contexto de versión: el artículo de septiembre de 2026 utiliza la serie 11.7 ESR. Existe la imagen 11.7.9 del ejemplo, pero eso no demuestra que sea el parche de seguridad más reciente hoy. Fije un parche soportado y siga los avisos de seguridad. Revise
env.exampley las notas del repositorio Docker oficial antes de instalar. Compruebe también la licencia de la edición.
Mattermost ofrece canales, mensajes directos, archivos, búsqueda, webhooks, bots, plugins y clientes de escritorio y móvil. Tiene sentido cuando:
- Los mensajes, archivos o datos de auditoría requieren control fuera de un SaaS público.
- Desarrollo, operaciones o soporte necesitan un servicio interno de comunicación.
- GitLab, Jira, CI/CD, alertas y ChatOps deben integrarse en canales comunes.
- Alguien puede mantener Linux, Docker, PostgreSQL, copias y actualizaciones.
- Es posible empezar con 10–50 personas y ampliar según carga medida.
Para unas pocas personas y un uso temporal sin responsable de recuperación, un servicio gestionado suele ser más sencillo. El alojamiento propio aporta control de datos e integración, pero cuesta VPS, dominio, correo, almacenamiento de objetos, espacio de copias y tiempo de mantenimiento.
| Servicio | Uso más adecuado | Ventaja | Responsabilidad o límite |
|---|---|---|---|
| Mattermost | Colaboración interna y ChatOps de desarrollo/operaciones | Datos controlados, webhooks/plugins, red privada | Servidor, base, copias, push y actualizaciones |
| Slack | Alta rápida, colaboración externa e integraciones SaaS | Menos mantenimiento de infraestructura | Tarifas y políticas de datos del SaaS |
| Discord | Comunidades, salas de voz y usuarios públicos | Herramientas comunitarias conocidas | Encaje limitado con datos empresariales estrictamente controlados |
Compare usuarios activos, archivos, cumplimiento, push, SSO y tamaño de llamadas. Una interfaz parecida a Slack no determina por sí sola el costo operativo.
El original cita una referencia de aplicación de 1 vCPU/2 GB para hasta unos 1.000 usuarios registrados. Usuarios registrados no equivalen a usuarios activos simultáneos ni garantizan capacidad del VPS completo. Plugins, búsqueda, archivos y llamadas cambian la demanda; PostgreSQL, Docker y Caddy también necesitan recursos.
| Carga | Punto de partida práctico | Disco | Condiciones |
|---|---|---|---|
| Piloto de 10–30 personas | 2 vCPU / 4 GB RAM | 60 GB NVMe | Texto y pocos archivos |
| 30–100 usuarios diarios | 4 vCPU / 8 GB RAM | 100–200 GB NVMe | Más plugins, webhooks y archivos |
| Más de 100 o alta actividad | 4–8 vCPU / 16 GB+ RAM | Valorar base/objetos separados | Probar carga antes de separar servicios |
Calcule archivos anuales como usuarios activos × volumen mensual por persona × 12 × margen 1,5. La fórmula original es:
一年附件容量 ≈ 活跃用户数 × 每人每月附件量 × 12 × 1.5 安全系数
Con 50 personas subiendo 100 MB al mes cada una, los archivos originales suman unos 60 GB anuales, antes del margen, base, registros, índices y backups. Un disco de 100 GB puede llenarse pronto. Para muchos archivos, considere S3 compatible; consulte la guía de MinIO.
Navegadores, escritorio y móviles acceden por HTTPS 443 a Caddy en el host. Caddy envía tráfico a Mattermost por loopback 8065 y este conecta a PostgreSQL por la red Docker. El medio de Calls llega directamente a Mattermost por UDP/TCP 8443. El diagrama original es:
浏览器 / 桌面端 / 手机端
│ HTTPS 443
▼
Caddy(宿主机)
│ 127.0.0.1:8065
▼
Mattermost 容器
│ Docker 内网 5432
▼
PostgreSQL 容器
Calls 媒体:客户端 ── UDP/TCP 8443 ──> Mattermost
Abra solo lo necesario para las funciones habilitadas:
22/tcp: SSH, preferiblemente limitado a direcciones administrativas.80/tcpy443/tcp: certificados y acceso web.8443/udpy8443/tcp: cuando utilice Calls.8065/tcp: solo en127.0.0.1, nunca público.5432/tcp: exclusivamente en la red Docker.
El proxy HTTP de Caddy no transporta el medio de 8443. Evalúe respaldo TCP o TURN si una red bloquea UDP, y RTCD para más carga. Verifique puertos publicados y firewall de nube: las publicaciones Docker pueden eludir lo esperado a partir únicamente de reglas UFW.
Use un subdominio como chat.example.com con A dirigido al IPv4 público. Publique AAAA únicamente con IPv6 funcional; un registro sin conectividad causa fallos intermitentes de certificados o clientes.
export MM_DOMAIN="chat.example.com"
getent ahosts "$MM_DOMAIN"
curl -4 https://ifconfig.me
Actualice el sistema y configure el firewall conservando acceso SSH antes de activarlo:
sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install -y ca-certificates curl git openssl ufw
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 8443/tcp
sudo ufw allow 8443/udp
sudo ufw enable
sudo ufw status verbose
Si no utiliza Calls, deje 8443 cerrado.
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list >/dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
sudo docker version
sudo docker compose version
Consulte la lista Compose de producción para healthchecks, rotación de registros y límites de recursos.
No utilice mattermost-preview en producción: Preview tiene contraseñas conocidas, correo deshabilitado, datos no persistentes y ninguna actualización normal.
sudo install -d -o "$USER" -g "$USER" -m 0750 /opt/mattermost
cd /opt/mattermost
git clone https://github.com/mattermost/docker.git
cd docker
cp env.example .env
Revise checkout y configuración:
git status --short
git log -1 --oneline
grep -E '^(POSTGRES_IMAGE_TAG|MATTERMOST_IMAGE|MATTERMOST_IMAGE_TAG)=' env.example
Registre el commit probado. Actualizar el repositorio puede cambiar rutas de volúmenes, variables o Compose aunque la imagen de la aplicación siga fijada.
Genere una contraseña fuerte:
openssl rand -base64 36
Edite /opt/mattermost/docker/.env y cambie al menos estos valores, conservando las demás entradas necesarias del ejemplo copiado:
DOMAIN=chat.example.com
TZ=Asia/Shanghai
RESTART_POLICY=unless-stopped
POSTGRES_IMAGE_TAG=18-alpine
POSTGRES_USER=mmuser
POSTGRES_PASSWORD=replace-with-a-long-random-password
POSTGRES_DB=mattermost
MATTERMOST_IMAGE=mattermost-team-edition
MATTERMOST_IMAGE_TAG=11.7.9
APP_PORT=8065
CALLS_PORT=8443
MM_SERVICESETTINGS_SITEURL=https://chat.example.com
La zona horaria es una elección de configuración: use la adecuada al equipo. Team Edition permite empezar la evaluación, sin prometer todas las funciones de producción. Revise los límites actuales de Entry, Professional y Enterprise para permisos, cumplimiento, push y Calls. Confirme un parche seguro soportado, sin copiar ciegamente 11.7.9. Fije PostgreSQL también: cambiar su versión mayor sobre datos existentes exige migración, no reinicio. El despliegue oficial actual monta los datos PostgreSQL 18 en su ruta padre esperada; conserve el mapeo del commit probado.
Proteja el archivo:
chmod 600 .env
El usuario Mattermost oficial tiene UID/GID 2000. Un propietario incorrecto suele producir reinicios y permission denied:
cd /opt/mattermost/docker
mkdir -p ./volumes/app/mattermost/{config,data,logs,plugins,client/plugins,bleve-indexes}
sudo chown -R 2000:2000 ./volumes/app/mattermost
PostgreSQL inicializa su directorio. No mezcle datos de aplicación y base en un montaje.
El archivo oficial docker-compose.without-nginx.yml publica 8065 en todas las direcciones del host. Use este override separado con Compose base para restringir web a loopback y mantener el medio de Calls:
cd /opt/mattermost/docker
cat >docker-compose.caddy.yml <<'YAML'
services:
mattermost:
ports:
- "127.0.0.1:${APP_PORT}:8065"
- "${CALLS_PORT}:${CALLS_PORT}/udp"
- "${CALLS_PORT}:${CALLS_PORT}/tcp"
YAML
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml config >/tmp/mattermost-compose.yml
grep -A12 'ports:' /tmp/mattermost-compose.yml
Compose expandido contiene la contraseña. Inspeccione con umask privado, no comparta el archivo y elimínelo tras comprobar que HostIp de 8065 es 127.0.0.1. No añada además el override de puertos públicos: Compose puede combinar listas de puertos.
Arranque después de verificar la configuración efectiva:
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml pull
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml up -d
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml ps
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml logs --tail=100 postgres mattermost
Compruebe salud local:
curl -fsS http://127.0.0.1:8065/api/v4/system/ping
ss -lntup | grep -E ':8065|:8443'
Ping debe devolver JSON con status: OK, y 8065 escuchar solo en 127.0.0.1. Elimine /tmp/mattermost-compose.yml después de inspeccionarlo.
sudo apt-get install -y debian-keyring debian-archive-keyring apt-transport-https curl gnupg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list >/dev/null
sudo apt-get update
sudo apt-get install -y caddy
Cree /etc/caddy/Caddyfile:
chat.example.com {
encode zstd gzip
reverse_proxy 127.0.0.1:8065 {
header_up X-Real-IP {remote_host}
header_up X-Forwarded-Proto {scheme}
}
log {
output file /var/log/caddy/mattermost-access.log {
roll_size 100MiB
roll_keep 7
}
}
}
Antes de recargar, dé al servicio acceso al directorio de registros: sudo install -d -o caddy -g caddy -m 0750 /var/log/caddy. reverse_proxy de Caddy admite WebSocket por defecto, sin reglas Upgrade manuales.
Valide y recargue:
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
sudo systemctl status caddy --no-pager
curl -I https://chat.example.com
curl -fsS https://chat.example.com/api/v4/system/ping
La guía completa Caddy trata HTTPS, registros y varios dominios.
Abra https://chat.example.com, cree cuenta y equipo iniciales y confirme el rol de administrador del sistema. Después:
- Defina nombre, correo de soporte y política de registro.
- Desactive registros públicos innecesarios; prefiera invitaciones o dominios controlados.
- Configure SMTP y compruebe invitaciones, restablecimientos y menciones.
- Revise tamaños y tipos de archivo permitidos.
- Instale solo plugins necesarios y registre versiones/permisos.
- Pruebe con una cuenta ordinaria además del administrador.
Si falla el correo, revise salida 587/465 y registros. Muchos proveedores bloquean 25. La ausencia de errores no demuestra entrega: compruebe también el buzón destinatario.
Notificaciones web/escritorio no prueban push con pantalla bloqueada. Hay tres opciones habituales:
- HPNS alojado para planes comerciales elegibles, según sus condiciones de producción.
- TPNS gratuito para pruebas, sin tratarlo como garantía de notificación productiva.
- Push Proxy propio, que necesita apps móviles compiladas de forma compatible y credenciales APNs/FCM.
Configure Push Notification Server en System Console. La cuenta A entra en el móvil y deja la app en segundo plano; B envía un mensaje desde navegador. Confirme su llegada. Para información sensible, evalúe qué contenido pasa por infraestructura push de terceros.
Empiece con Calls integrado para un equipo pequeño. Abra 8443 UDP/TCP en firewall local y nube y revise el plugin:
sudo ufw status numbered
sudo ss -lunp | grep ':8443'
sudo ss -ltnp | grep ':8443'
Use dos cuentas en redes distintas, como banda ancha doméstica y celular. Una prueba en la misma LAN no revela problemas de IP pública, NAT o UDP filtrado.
Para llamadas frecuentes con más de 50 personas, medios fiables o grabación, evalúe RTCD, TURN y Calls Offloader oficiales. Grabación, transcripción y grupos mayores pueden necesitar licencia comercial; revise derechos antes de comprar recursos.
Una copia recuperable incluye:
- PostgreSQL.
volumes/app/mattermost/config.- Archivos locales de
volumes/app/mattermost/data. - Plugins y configuración de índices Bleve.
.envy Compose personalizados.- Configuración Caddy y credenciales externas necesarias.
Detenga Mattermost dejando PostgreSQL activo para obtener un punto coherente. La secuencia original es:
cd /opt/mattermost/docker
set -a
. ./.env
set +a
BACKUP_DIR="/var/backups/mattermost/$(date +%F-%H%M%S)"
sudo install -d -m 0700 "$BACKUP_DIR"
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml stop mattermost
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml exec -T postgres \
pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc >"$BACKUP_DIR/mattermost.pgdump"
sudo tar -C /opt/mattermost/docker -czf "$BACKUP_DIR/mattermost-files.tgz" \
.env docker-compose.caddy.yml volumes/app
sudo cp /etc/caddy/Caddyfile "$BACKUP_DIR/Caddyfile"
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml start mattermost
sudo sha256sum "$BACKUP_DIR"/* | sudo tee "$BACKUP_DIR/SHA256SUMS"
sudo du -sh "$BACKUP_DIR"
No ejecute esa secuencia sin cambios como usuario ordinario: el shell redirige antes de que sudo dé acceso al directorio 0700 de root. Tampoco maneja fallos y puede dejar la aplicación detenida. Use este script como root para los archivos locales documentados; evita ejecutar dotenv como shell, impide copias simultáneas e intenta reiniciar ante un error:
#!/usr/bin/env bash
set -euo pipefail
test "$(id -u)" -eq 0
cd /opt/mattermost/docker
umask 077
exec 9>/run/lock/mattermost-backup.lock
flock -n 9
MM_BACKUP="/var/backups/mattermost/$(date -u +%Y%m%dT%H%M%SZ)"
install -d -m 0700 "$MM_BACKUP"
mm_compose() {
docker compose -f docker-compose.yml -f docker-compose.caddy.yml "$@"
}
trap 'mm_compose start mattermost >&2' EXIT
mm_compose stop mattermost
mm_compose exec -T postgres sh -eu -c \
'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
>"$MM_BACKUP/mattermost.pgdump"
tar -czf "$MM_BACKUP/mattermost-files.tgz" \
.env docker-compose.yml docker-compose.caddy.yml volumes/app
cp /etc/caddy/Caddyfile "$MM_BACKUP/Caddyfile"
git rev-parse HEAD >"$MM_BACKUP/deployment-commit.txt"
mm_compose config >"$MM_BACKUP/compose.rendered.yaml"
(
cd "$MM_BACKUP"
sha256sum mattermost.pgdump mattermost-files.tgz Caddyfile \
deployment-commit.txt compose.rendered.yaml >SHA256SUMS
sha256sum -c SHA256SUMS
)
mm_compose start mattermost
trap - EXIT
touch "$MM_BACKUP/COMPLETE"
chmod -R go-rwx "$MM_BACKUP"
printf 'Backup complete: %s\n' "$MM_BACKUP"
El trap solicita reinicio; la monitorización debe confirmar la salud. Acepte solo copias con COMPLETE y checksums verificados. Un almacén externo necesita su snapshot coordinado. /var/backups está en el disco del VPS: cifre y copie fuera del host, con retención. Consulte la guía de backups automáticos.
No espere una avería para probar pg_restore. En un VPS aislado:
- Use versiones Docker, Mattermost y PostgreSQL iguales o compatibles.
- Restaure
.env, Compose y directorios de aplicación. - Arranque PostgreSQL con una base destino vacía.
- Importe con
pg_restore --clean --if-exists, verificando destino y credenciales. - Restaure propietario
2000:2000. - Arranque Mattermost y revise canales, mensajes, archivos, plugins y búsqueda.
- Use dominio de prueba para login, subidas/descargas, correo y Calls.
Mantenga la aplicación detenida durante la restauración. Compruebe mensajes históricos y archivos originales; registre el tiempo y la interrupción aceptable. Un código de salida correcto no basta.
Los parches de seguridad son frecuentes. Lea cada paso requerido entre versiones; no salte varias versiones mayores a una imagen latest.
cd /opt/mattermost/docker
git fetch --all --tags
git status --short
git diff env.example
Tras verificar una copia completa, cambie MATTERMOST_IMAGE_TAG en .env y ejecute:
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml pull mattermost
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml up -d
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml ps
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml logs --tail=200 mattermost
curl -fsS https://chat.example.com/api/v4/system/ping
La actualización migra la base. Volver solo a la imagen anterior puede fallar con schema cambiado. Restaure base, archivos y configuración del mismo punto previo e inicie la imagen original. Prepare mantenimiento, criterios de parada y restauración probada en clon.
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml ps
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml logs --tail=200 postgres mattermost
sudo namei -l volumes/app/mattermost/config
sudo chown -R 2000:2000 volumes/app/mattermost
Revise credenciales coincidentes, permisos de montajes, disco lleno y caracteres especiales en .env.
Revise WebSocket del navegador, registros Caddy y Site URL:
sudo journalctl -u caddy -n 100 --no-pager
sudo tail -n 100 /var/log/caddy/mattermost-access.log
grep '^MM_SERVICESETTINGS_SITEURL=' /opt/mattermost/docker/.env
Causas comunes: Site URL HTTP, DNS antiguo o un CDN/proxy adicional sin WebSocket correcto.
df -h
df -i
sudo du -sh /opt/mattermost/docker/volumes/app/mattermost/data
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml logs --tail=100 mattermost
Compruebe límites de aplicación/CDN y propietario de directorios. Aumentar el límite del proxy no cambia el de Mattermost.
Revise 8443 UDP/TCP, seguridad de nube, IP pública de NAT y filtrado UDP. Caddy trata señalización HTTPS/WebSocket en 443, sin transportar medios 8443.
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml exec -T postgres pg_isready -U mmuser -d mattermost
sudo docker compose -f docker-compose.yml -f docker-compose.caddy.yml logs --tail=100 postgres
Mantenga 5432 privado durante el diagnóstico. Consulte la guía de conexiones PostgreSQL.
- Dominio, certificados y
/api/v4/system/pingfuncionan. - 8065 es solo loopback y 5432 no es público.
- Usuarios normales entran, envían y suben/descargan archivos.
- Web y escritorio reciben mensajes en tiempo real.
- Llegan invitaciones y restablecimientos SMTP.
- Dos cuentas reales verifican push con pantalla bloqueada.
- Calls funciona entre dos redes distintas.
- Base, archivos, configuración y claves tienen copias cifradas externas.
- Se ha completado restauración aislada.
- Versiones fijadas y seguimiento de avisos de seguridad.
No active todos los plugins, SSO, opciones de búsqueda, grabación y objetos el primer día. Deje que 10–20 personas lo utilicen dos semanas. Mida CPU, RAM, disco, base, archivos y fallos de llamadas; después decida qué ampliar o separar.
Incluya mensajes en tiempo real, push móvil, archivos recuperables y retorno probado en la aceptación. Así podrá mantener la colaboración más allá de la demostración inicial Docker.