Instalar Docmost con Docker Compose: wiki autoalojada para equipos

Docmost es una plataforma wiki y de documentación colaborativa de código abierto, creada como alternativa autoalojada a Confluence y Notion. Con más de 21.200 estrellas en GitHub y una comunidad activa, se ha convertido en una de las opciones de wiki autoalojada más populares para equipos que quieren ser dueños de sus datos.

Docmost te ofrece un editor colaborativo en tiempo real con formato de texto enriquecido, soporte para Markdown, anidación de páginas, espacios para organizar el contenido por equipo o proyecto, y comentarios en línea. Funciona con TypeScript, PostgreSQL y Redis, lo que hace que la instalación con Docker Compose sea sencilla. Tres contenedores y ya está en marcha.

Esta guía recorre una instalación completa de Docmost con Docker Compose en un VPS Linux: la configuración de compose actualizada, las variables de entorno, SSL con proxy inverso y los detalles con los que la gente suele tropezar (cabeceras WebSocket, longitud de APP_SECRET, contraseñas de base de datos).

Si quieres monitorizar los recursos del servidor como CPU, memoria y espacio en disco después del despliegue, consulta cómo monitorizar los recursos del servidor y de Docker.

Si buscas otras aplicaciones autoalojadas de documentación y notas, consulta también:

• Cómo instalar Outline Wiki con Docker
• Cómo instalar Memos con Docker Compose

¿Qué es Docmost? Una alternativa autoalojada a Confluence

Docmost se posiciona directamente contra Confluence y Notion. La diferencia: lo alojas tú mismo, eres dueño de los datos y la Community Edition es gratuita bajo la licencia AGPL 3.0.

El proyecto está respaldado por una empresa comercial que vende funciones Enterprise (SSO, MFA, chat con IA) sobre el núcleo de código abierto. La Community Edition cubre todo lo que la mayoría de equipos necesita para un wiki compartido: edición en tiempo real, espacios, permisos, historial de páginas, adjuntos y búsqueda.

Funciones clave (Community vs Enterprise)

Community Edition (gratuita, AGPL 3.0):

Enterprise Edition (de pago):

SSO (SAML, OIDC, LDAP), MFA (TOTP), chat con IA compatible con MCP, flujos de verificación de páginas, aprovisionamiento SCIM, importación de PDF, exportación DOCX, búsqueda con Typesense, registros de auditoría y controles de seguridad.

Guía de instalación de Docmost con Docker Compose

Esta es la guía completa paso a paso para instalar Docmost con Docker Compose. El archivo compose de abajo se basa en la plantilla oficial del repositorio de Docmost (v0.95.0, julio de 2025).

Requisitos previos para el despliegue con Docker

Antes de empezar, asegúrate de tener:

Los precios de los VPS subieron en todos los proveedores en 2026 — si estás reconsiderando un servidor alquilado, mira qué cambió y cuándo un mini PC sale ganando.

Si quieres gestionar tus contenedores Docker con una interfaz web, consulta Dockge: gestor de Docker Compose para self-hosting.

Configuración de Docker Compose

services:
  docmost:
    image: docmost/docmost:latest
    depends_on:
      - db
      - redis
    environment:
      APP_URL: 'https://docs.example.com'
      APP_SECRET: 'REPLACE_WITH_LONG_SECRET'
      DATABASE_URL: 'postgresql://docmost:STRONG_DB_PASSWORD@db:5432/docmost?schema=public'
      REDIS_URL: 'redis://redis:6379'
    ports:
      - "3000:3000"
    restart: unless-stopped
    volumes:
      - docmost:/app/data/storage

  db:
    image: postgres:18
    environment:
      POSTGRES_DB: docmost
      POSTGRES_USER: docmost
      POSTGRES_PASSWORD: STRONG_DB_PASSWORD
    restart: unless-stopped
    volumes:
      - db_data:/var/lib/postgresql

  redis:
    image: redis:8
    command: ["redis-server", "--appendonly", "yes", "--maxmemory-policy", "noeviction"]
    restart: unless-stopped
    volumes:
      - redis_data:/data

volumes:
  docmost:
  db_data:
  redis_data:

services:
  docmost:
    image: docmost/docmost:latest
    depends_on:
      - db
      - redis
    environment:
      APP_URL: "${APP_URL}"
      APP_SECRET: "${APP_SECRET}"
      DATABASE_URL: "postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}?schema=public"
      REDIS_URL: "redis://redis:6379"
    ports:
      - "3000:3000"
    restart: unless-stopped
    volumes:
      - docmost:/app/data/storage

  db:
    image: postgres:18
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    restart: unless-stopped
    volumes:
      - db_data:/var/lib/postgresql

  redis:
    image: redis:8
    command: ["redis-server", "--appendonly", "yes", "--maxmemory-policy", "noeviction"]
    restart: unless-stopped
    volumes:
      - redis_data:/data

volumes:
  docmost:
  db_data:
  redis_data:

APP_URL=https://docs.example.com
APP_SECRET=REPLACE_WITH_GENERATED_SECRET
POSTGRES_DB=docmost
POSTGRES_USER=docmost
POSTGRES_PASSWORD=STRONG_DB_PASSWORD

Tres servicios:

1. docmost: la aplicación. Mapea el puerto 3000 del host. Monta un volumen con nombre para los adjuntos en /app/data/storage.
2. db: PostgreSQL 18. Almacena todo el contenido del wiki, los usuarios y los metadatos. Usa un volumen con nombre para la persistencia de datos.
3. redis: Redis 8. Gestiona la caché y el estado de las sesiones. Se ejecuta con appendonly yes para persistencia y noeviction para evitar pérdida de datos bajo presión de memoria.

Cambios clave respecto a guías antiguas de Docmost con Docker Compose: postgres:18 (sin Alpine, imagen más grande pero más compatible), redis:8 con política de memoria explícita, volúmenes con nombre en lugar de bind mounts, y sin la línea version: "3" (obsoleta en Docker Compose v2).

Variables de entorno explicadas

Genera el APP_SECRET:

openssl rand -hex 32

Esto produce una cadena hexadecimal de 64 caracteres (muy por encima del mínimo de 32).

Para secretos de producción, considera gestionar de forma segura los secretos de Docker Compose en lugar de escribirlos directamente en el archivo compose.

MAIL_DRIVER: smtp
SMTP_HOST: smtp.example.com
SMTP_PORT: "587"
SMTP_USERNAME: your_username
SMTP_PASSWORD: your_password
SMTP_SECURE: "false"
MAIL_FROM_ADDRESS: [email protected]
MAIL_FROM_NAME: Docmost

STORAGE_DRIVER: s3
AWS_S3_ACCESS_KEY_ID: "your-key"
AWS_S3_SECRET_ACCESS_KEY: "your-secret"
AWS_S3_REGION: "auto"
AWS_S3_BUCKET: "docmost-attachments"
AWS_S3_ENDPOINT: "https://your-s3-endpoint.com"  # for non-AWS providers
AWS_S3_FORCE_PATH_STYLE: "true"  # required for most S3-compatible providers

STORAGE_DRIVER: azure
AZURE_STORAGE_ACCOUNT_NAME: "your-account"
AZURE_STORAGE_ACCOUNT_KEY: "your-key"
AZURE_STORAGE_CONTAINER: "docmost-attachments"

Desplegar el stack

Cuando tengas listo el archivo compose (y el archivo .env si usas ese enfoque), despliega con:

docker compose up -d

Esto descarga las imágenes, crea los contenedores y los inicia en segundo plano. El primer arranque tarda entre 60 y 90 segundos porque Docmost ejecuta las migraciones de base de datos antes de aceptar conexiones.

Nota: el comando es docker compose (plugin v2, sin guion). El antiguo docker-compose (v1) todavía funciona como alias en la mayoría de sistemas, pero la documentación oficial usa la sintaxis v2.

Verificar la instalación

Después de docker compose up -d, ejecuta estas comprobaciones:

# All 3 services should show "Up"
docker compose ps

Salida esperada:

NAME                IMAGE                  STATUS
docmost-app-1       docmost/docmost:latest Up
docmost-db-1        postgres:18            Up
docmost-redis-1     redis:8                Up

Revisa los logs de la aplicación para ver el progreso de las migraciones:

docker compose logs -f docmost

Cuando veas que la app escucha en el puerto 3000, prueba el endpoint de salud:

curl http://localhost:3000/api/health

Debería devolver OK. Después abre tu APP_URL en un navegador. Deberías ver la página de configuración para crear tu cuenta de administrador.

Proxy inverso y SSL para Docmost

Docmost necesita un proxy inverso para la terminación TLS y el enrutamiento del dominio. Hay un requisito crítico que pilla a la mayoría de la gente:

Configuración de Cloudflare Tunnel con soporte WebSocket

Los túneles de Cloudflare admiten conexiones WebSocket por defecto. No hace falta configuración adicional. Este es el enfoque SSL más sencillo.

Ve a Access > Tunnels en el panel de Cloudflare, elige tu túnel y añade un hostname:

• Hostname: docs.yourdomain.com
• Service: http://127.0.0.1:3000

También puedes usar el proxy inverso de CloudPanel con Docker como otro enfoque.

Configuración de proxy inverso con Nginx

Para Nginx con SSL de Let’s Encrypt (vía certbot), crea este bloque de servidor:

server {
    listen 80;
    server_name docs.example.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Luego obtén el certificado SSL con certbot:

certbot --nginx -d docs.example.com

Las líneas proxy_http_version 1.1, Upgrade y Connection "upgrade" son las cabeceras WebSocket obligatorias. Sin ellas, el editor carga en modo de solo lectura.

Integración con Traefik mediante etiquetas Docker

Si usas Traefik (v3.6+), añade estas etiquetas al servicio docmost en tu archivo compose. Traefik admite WebSockets de forma nativa — no hace falta configuración adicional.

  docmost:
    image: docmost/docmost:latest
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.docmost.rule=Host(`docs.example.com`)"
      - "traefik.http.routers.docmost.entrypoints=websecure"
      - "traefik.http.routers.docmost.tls.certresolver=letsencrypt"
      - "traefik.http.services.docmost.loadbalancer.server.port=3000"
    # ... rest of service config

Para una configuración completa de Traefik con Docker, consulta Traefik como proxy inverso en Docker.

Actualizar tu instalación de Docmost con Docker

Si ejecutas una versión antigua de Docmost, actualizar suele ser sencillo:

cd ~/docmost
docker compose pull
docker compose up -d

Esto descarga las imágenes más recientes y reinicia los contenedores. Docmost gestiona las migraciones de base de datos automáticamente al arrancar.

Copia de seguridad y restauración de tu wiki autoalojada

Copia de seguridad de la base de datos:

docker compose exec db pg_dump -U docmost docmost > docmost-backup-$(date +%Y%m%d).sql

Automatízala con un cron (diaria a las 3 AM):

0 3 * * * cd /path/to/docmost && docker compose exec db pg_dump -U docmost docmost > /backups/docmost-$(date +\%Y\%m\%d).sql

Copia de seguridad de los adjuntos:

Si usas almacenamiento local (el predeterminado), los adjuntos están en el volumen con nombre docmost. Haz la copia con:

docker run --rm -v docmost_docmost:/data -v /backups:/backup alpine tar czf /backup/docmost-files-$(date +%Y%m%d).tar.gz -C /data .

Si usas almacenamiento S3 o Azure, tus adjuntos ya están fuera del servidor — solo asegúrate de que tu bucket tenga el versionado activado.

Restaurar la base de datos:

docker compose exec -T db psql -U docmost docmost < docmost-backup-20250708.sql

Almacenamiento fuera del servidor: copia tus backups a otro servidor o a un almacenamiento compatible con S3. Una copia de seguridad en el mismo disco no es una copia de seguridad.

Solución de problemas comunes de Docmost con Docker

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

openssl rand -hex 32
# Copy the output, replace APP_SECRET in your compose file or .env
docker compose up -d

# Check logs for the exact error
docker compose logs db
docker compose logs docmost

docker compose down -v  # WARNING: deletes all data volumes
# Fix the password in your compose file
docker compose up -d

docker compose ps       # Check if docmost is "Up"
docker compose logs docmost  # Check for startup errors

journalctl -u cloudflared -f

Conclusión

Docmost es una sólida plataforma de wiki y documentación autoalojada. Con más de 21.200 estrellas en GitHub, desarrollo activo (versión actual v0.95.0) y un conjunto de funciones real para la colaboración en equipo, es una de las mejores alternativas a Confluence que puedes ejecutar por tu cuenta.

La instalación con Docker Compose son tres contenedores — la app, PostgreSQL y Redis. Los principales detalles a tener en cuenta son:

• APP_SECRET debe tener 32+ caracteres (genéralo con openssl rand -hex 32)
• APP_URL debe incluir https:// para que funcionen las cookies de autenticación
• Las cabeceras WebSocket deben configurarse en tu proxy inverso o el editor será de solo lectura
• Las contraseñas de base de datos deben coincidir entre DATABASE_URL y POSTGRES_PASSWORD

Configura las copias de seguridad desde el primer día. Un cron con pg_dump no cuesta nada y te salva cuando algo sale mal.

Para más contenedores Docker autoalojados para tu servidor doméstico, consulta la lista completa de contenedores Docker para servidor doméstico.