Guía de despliegue

Cómo autoalojar Docmost en un VPS

Desplegar en un VPS Cloud →

Tutorial

Cómo autoalojar Docmost en un VPS

Autoalojamiento3 min de lectura6 pasos

Docmost es un wiki colaborativo open source pensado para los equipos que quieren una alternativa a Notion y Confluence sin tarifas por usuario y sin que sus datos salgan de su infraestructura. Edición colaborativa en tiempo real, diagramas Mermaid y Draw.io integrados, páginas anidadas y búsqueda de texto completo: todo funcionando sobre tres contenedores Docker. Así se despliega en un VPS en menos de 15 minutos.

Contenido· Por qué autoalojar Docmost en lugar de Notion o Confluence1/6
  1. 01Por qué autoalojar Docmost en lugar de Notion o Confluence
  2. 02Lo que le aporta una instancia de Docmost autoalojada
  3. 03Requisitos previos
  4. 04Desplegar Docmost en su VPS
  5. 05Haga copia de seguridad de sus volúmenes
  6. 06La documentación oficial

Por qué autoalojar Docmost en lugar de Notion o Confluence

Notion y Confluence son cómodos, pero vienen acompañados de concesiones que pesan en los equipos de desarrollo: una tarificación por usuario que aumenta con la plantilla, documentos alojados en la infraestructura de un proveedor SaaS y restricciones de exportación el día que quiera marcharse. Docmost funciona en su propio VPS: todas las páginas, los archivos adjuntos y los índices de búsqueda permanecen en su servidor. Usted controla la política de copias de seguridad, las reglas de retención y los permisos de acceso. Para las empresas que manejan datos de clientes o documentación técnica interna, no es un detalle menor.

Lo que le aporta una instancia de Docmost autoalojada

  • Edición colaborativa en tiempo real: varios miembros del equipo en la misma página, cero conflictos, los cambios aparecen al instante.
  • Árbol de páginas anidadas con reorganización mediante arrastrar y soltar, y profundidad ilimitada.
  • Bloques Mermaid, Draw.io y Excalidraw integrados: ningún plugin externo necesario para los diagramas.
  • Búsqueda de texto completo en el conjunto de las páginas y de los archivos adjuntos.
  • Historial de páginas y diff: vea exactamente quién modificó qué y vuelva atrás con un clic.
  • Permisos detallados: control de acceso a nivel de espacio de trabajo, de grupo y de cada página.
  • Cero coste por usuario: solo paga su VPS.

Requisitos previos

Necesita un VPS con al menos 2 GB de RAM (4 GB para equipos de 10 personas o más), Docker y Docker Compose instalados, y un dominio o subdominio apuntando a la IP de su VPS. La stack de Docmost cabe en tres contenedores: la aplicación (Node.js), PostgreSQL 16 y Redis 7. En un VPS moderno de 2 vCPU, servirá cómodamente de 20 a 30 editores simultáneos.

Desplegar Docmost en su VPS

  1. Instalar Docker

    Conéctese por SSH a su VPS y ejecute curl -fsSL https://get.docker.com | sh para instalar Docker y el plugin Compose en un solo paso. Verifique con docker compose version.

  2. Generar los secretos

    Ejecute openssl rand -hex 32 dos veces: una para APP_SECRET y otra para POSTGRES_PASSWORD. Cree /opt/docmost/.env con APP_URL=https://docs.su-dominio.com, APP_SECRET=<value>, DATABASE_URL=postgresql://docmost:<pg-pw>@db/docmost y REDIS_URL=redis://redis:6379.

  3. Redactar docker-compose.yml

    Cree /opt/docmost/docker-compose.yml con tres servicios: docmost (docmost/docmost:latest, puerto 3000:3000, variables de entorno tomadas del .env), db (postgres:16-alpine, POSTGRES_DB=docmost, volumen docmost_db) y redis (redis:7-alpine, --appendonly yes, volumen docmost_redis). Ejecute después docker compose up -d.

  4. Configurar el reverse proxy y el SSL

    Con Caddy (lo más sencillo): añada docs.su-dominio.com { reverse_proxy localhost:3000 } a su Caddyfile y recargue. Con Nginx: proxy_pass http://127.0.0.1:3000; dentro de un bloque server y ejecute después Certbot. Actualice APP_URL en el .env y reinicie: docker compose restart docmost.

  5. Crear su espacio de trabajo

    Abra la URL en su navegador, cree la primera cuenta de administrador y ponga nombre a su espacio de trabajo. Invite a sus compañeros por correo electrónico desde Ajustes → Miembros. Empiece por una página de inicio y construya después su árbol de páginas: mueva las páginas arrastrando y soltando para reorganizarlas en cualquier momento.

  6. Conectarse por primera vez

    Abra la URL inmediatamente después de la instalación: Docmost muestra su pantalla de configuración inicial, donde usted crea el espacio de trabajo y la cuenta de propietario (nombre, correo electrónico, contraseña). Esta primera cuenta tiene todos los permisos.

Haga copia de seguridad de sus volúmenes

Todos los datos de Docmost residen en dos volúmenes Docker: docmost_db (PostgreSQL) y docmost_data (archivos adjuntos). Programe una copia de seguridad diaria: docker run --rm -v docmost_db:/data -v /backups:/out alpine tar czf /out/docmost-$(date +%F).tar.gz /data. Almacénela fuera del servidor para una estrategia completa de recuperación ante desastres.

La documentación oficial

Para la configuración avanzada y las opciones propias de la herramienta, consulte la documentación oficial de Docmost. Esta guía cubre la puesta en línea en un VPS; la documentación del editor sigue siendo la referencia para los ajustes finos, las actualizaciones mayores y los casos de uso específicos.

Aloje el wiki de su equipo en un VPS

Despliegue Docmost en un VPS ServOrbit y mantenga el conocimiento de su equipo en su propia infraestructura — sin tarifas por usuario, sin dependencia de un proveedor.

¿Necesita ayuda?

Consulte nuestro centro de ayuda y nuestra FAQ, o contacte con nuestro equipo: llamada, WhatsApp o correo electrónico. Soporte en francés, inglés y árabe.

Escribir por WhatsAppse abre en una pestaña nueva