Por qué autoalojar Wiki.js en un VPS
Wiki.js destaca por su capacidad de tratar cada página como un archivo Markdown sincronizado con Git: su documentación se convierte en un repositorio versionado, en el que cada modificación es trazable y reversible. Esta lógica de almacenamiento en texto plano le protege del bloqueo propietario, siempre que usted controle la infraestructura. En un VPS, conecta Wiki.js a su propio repositorio GitHub o GitLab, elige su motor de almacenamiento (PostgreSQL recomendado) y activa los módulos que desee: autenticación LDAP, comentarios, búsqueda avanzada. A diferencia de un SaaS, nada limita el número de páginas, de editores ni de espacios, y puede alojar varios wikis en el mismo servidor gracias al reverse proxy.
Los beneficios de un Wiki.js autoalojado
- Versionado Git nativo: cada página es un archivo Markdown sincronizado con su repositorio.
- Editor visual o Markdown a elección, con vista previa en tiempo real y coloreado de sintaxis.
- Múltiples módulos de autenticación: local, LDAP, OAuth2, SAML, todos configurables desde la administración.
- Búsqueda integrada con varios motores (base de datos, Elasticsearch) según su carga.
- Gestión detallada de permisos por carpeta y por grupo, ideal para compartimentar la documentación interna.
- Alojamiento multiwiki en un solo VPS mediante subdominios y un único reverse proxy.
Requisitos de hardware y software
Wiki.js es sobrio: 1 vCPU y 2 GB de RAM bastan para un wiki de equipo con lectura intensiva, ya que el motor Node.js consume poco. Prevea 2 GB de RAM adicionales si activa Elasticsearch para la búsqueda de texto completo a gran escala. El disco depende sobre todo de los archivos adjuntos; de 10 a 20 GB constituyen una base razonable. En cuanto al software: Docker y docker compose v2, un dominio o subdominio apuntando al VPS (docs.suempresa.com) y un PostgreSQL 12+ dedicado. Si desea la sincronización Git, prepare una clave SSH de despliegue con acceso de escritura a su repositorio antes del primer arranque.
Desplegar Wiki.js paso a paso
Aprovisionar el VPS y Docker
Tras actualizar el sistema, instale Docker y el plugin compose. Cree
/opt/wikijsy un archivodocker-compose.yml. Wiki.js necesita una base de datos: declararemos PostgreSQL en la misma stack.Declarar PostgreSQL y Wiki.js
Defina un servicio
dbcon la imagenpostgres:15, un volumen persistente y las variablesPOSTGRES_DB=wiki,POSTGRES_USER,POSTGRES_PASSWORD. Añada el serviciowikicon la imagenghcr.io/requarks/wiki:2y enlácelo con la base medianteDB_TYPE=postgresyDB_HOST=db.Arrancar y acceder al asistente de instalación
Inicie con
docker compose up -d. Wiki.js aplica automáticamente sus migraciones en el primer arranque. Abra el puerto3000en la red interna y acceda al asistente, que le pedirá el correo y la contraseña del administrador.Configurar el reverse proxy y el SSL
Coloque Caddy o Nginx delante de Wiki.js. Con Nginx, cree un vhost para
docs.suempresa.comque haga de proxy hacialocalhost:3000y utilicecertbotpara obtener el certificado Let's Encrypt. Después indique la URL canónica en la administración de Wiki.js.Conectar la sincronización Git
En Administración > Almacenamiento, active el módulo Git, pegue la URL SSH de su repositorio y la clave de despliegue. Elija el modo bidireccional para que cada edición envíe un commit, garantizando un historial versionado de toda la documentación.
Iniciar sesión por primera vez
Abra la URL en cuanto termine la instalación: Wiki.js muestra su asistente, que le pide crear USTED MISMO la cuenta de administrador (correo + contraseña) y la URL del sitio. Hágalo de inmediato: mientras el asistente no se complete, el primer visitante se convierte en administrador del wiki.
Active el almacenamiento Git en modo bidireccional, pero configure una cuenta de máquina dedicada con su propio nombre de committer. Obtendrá un historial limpio en el que cada página modificada desde la interfaz genera un commit atribuido al wiki, lo que facilita las auditorías de documentación y permite restaurar una versión anterior con un simple git revert.
La documentación oficial
Para la configuración avanzada y las opciones propias de la herramienta, consulte la documentación oficial de Wiki.js. 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.
