Cómo instalar Outline en Docker - Wiki y base de conocimiento colaborativa autohospedada en Docker
Outline: Wiki y base de conocimiento colaborativa autohospedada en Docker
Wiki rápida y moderno para equipos. Editor Markdown en tiempo real. Búsqueda instantánea. Colecciones organizadas. Edición colaborativa. PostgreSQL. Redis. S3/MinIO. OAuth/SAML.
¿Qué es Outline?
Outline es una base de conocimiento colaborativa moderna diseñada específicamente para equipos que necesitan wiki rápido, bonito, y fácil de usar. A diferencia de Notion (complejo, SaaS), Confluence (enterprise pesado), o Docusaurus (estático), Outline es una aplicación web reactiva diseñada para colaboración en tiempo real con búsqueda instantánea.
Características principales: Editor Markdown con soporte colaborativo en tiempo real. Búsqueda full-text rápida (busca contenido y títulos). Colecciones para organizar documentos sin jerarquía rígida. Comentarios en documentos. Versionado de documentos. Autenticación OAuth/SAML (Google, Slack, OIDC). PostgreSQL backend. Redis para sesiones/caché. S3 o MinIO para almacenamiento de archivos. Interfaz moderna React + Node.js. Responsive (desktop, tablet, móvil). Permisos granulares (viewer, editor, admin). Integración con Slack, GitHub, Zapier. Open source AGPL-3.0. Docker ready.
Características principales
Editor Markdown colaborativo
Múltiples usuarios editan mismo documento. Cambios en vivo. Cursores visibles.
Búsqueda instantánea
Full-text search ultra-rápido. Busca contenido, no solo títulos. Resultados en tiempo real.
Colecciones organizadas
Agrupa documentos sin jerarquía fija. Flexible. Sub-colecciones. Permisos por colección.
Comentarios y discusión
Comenta en documentos. Threading. Resuelve discusiones. @menciones.
Versionado de documentos
Historial completo de cambios. Restaura versiones antiguas. Quién cambió qué y cuándo.
Autenticación flexible
OAuth: Google, Slack, GitHub. SAML (Enterprise). OIDC custom. Multi-tenancy.
Permisos granulares
Viewer, Editor, Admin. Por usuario, por colección. Público/privado.
Integraciones
Slack (crear docs desde Slack), GitHub (link repos), Zapier, API REST.
Almacenamiento flexible
S3 (AWS) o MinIO (self-hosted). Archivos attachments, avatares, imágenes.
Responsive design
Desktop, tablet, móvil. Interfaz moderna React. Carga rápida.
Open source AGPL-3.0
Código abierto. Customizable. Comunidad activa.
Docker listo
Docker Compose. PostgreSQL + Redis. MinIO incluido. Deploy en minutos.
Requisitos del sistema
- Docker & Docker Compose
- 2-4 GB RAM (Node.js + PostgreSQL + Redis)
- 10+ GB espacio disco (BD + documentos + adjuntos)
- Puerto 3000 para Outline (configurable)
- PostgreSQL (incluido en docker-compose)
- Redis (incluido en docker-compose)
- Almacenamiento S3/MinIO (MinIO incluido para self-hosted completo)
- Proveedor de autenticación: Google OAuth, Slack, OIDC, o SAML
Instalación con Docker Compose
Paso 1: Clonar repositorio con docker-compose
Paso 2: Configurar variables de entorno
Paso 3: Generar configuración y iniciar
Acceder
http://localhost:3000 o tu dominio configurado
Primeros pasos
1. Login con OAuth
- Abre Outline en navegador
- Botón "Sign in with Google" (o tu proveedor)
- Autentica con Google/Slack/etc
- Serás redirigido a Outline como nuevo usuario
2. Crear colección
- Dashboard → New Collection
- Nombre: "Documentación", "Procesos", etc
- Descripción (opcional)
- Permisos: privada o pública
- Crear
3. Crear primer documento
- Abre colección
- New Document
- Escribe en Markdown
- Auto-guarda constantemente
4. Invitar colaboradores
- Settings → Members
- Invita por email
- Asigna roles: Viewer, Editor, Admin
- Ellos reciben email con link invitación
5. Usar editor Markdown
6. Buscar documentos
- Buscador superior (lupa)
- Escribe palabras clave
- Busca en contenido, títulos, comentarios
- Resultados instantáneos
7. Comentar y colaborar
- Click "Comment" en documento
- Escribe feedback
- Otros ven comentarios en tiempo real
- Resuelve cuando ya no es relevante
Casos de uso
- Documentación técnica: APIs, arquitectura, runbooks, post-mortems.
- Knowledge base empresarial: Políticas, procedimientos, best practices.
- Onboarding: Guías para nuevos empleados. Self-service learning.
- Equipo remoto: Wiki colaborativa para equipos distribuidos.
- Proyectos open source: Documentación comunitaria con permisos.
- Company wiki: Cultura, valores, historias, decisiones.
- Notas de reuniones: Centraliza notas, decisiones, action items.
Configurar OIDC (si no quieres OAuth Google/Slack)
Opción: Usar Dex como proveedor OIDC local
Si no quieres depender de Google/Slack, puedes usar Dex (OIDC provider simple) para autenticación local.
Luego configura Outline para usar OIDC apuntando a Dex. Ver documentación Outline + Dex.
HTTPS con Caddy (producción)
Caddyfile
Actualizar APP_HOST en variables de entorno
Acceso remoto seguro
https://outline.tudominio.com con HTTPS automático de Caddy
Gestión y mantenimiento
Ver logs
Backup de base de datos PostgreSQL
Restore de backup
Reiniciar servicios
Actualizar Outline a versión más reciente
Monitorear consumo de recursos
Agregar nuevo usuario desde admin
Dashboard → Settings → Members → Invite
Comparativa con alternativas
vs Notion
Outline gana: Self-hosted, más rápido, más simple, colaboración real-time. Notion gana: Más potente, bases de datos, más features.
vs Confluence
Outline gana: Más moderno, más simple, más barato. Confluence gana: Enterprise features, JIRA integration.
vs Docusaurus
Outline gana: Dinámico, colaborativo, BD. Docusaurus gana: Estático, optimizado SEO, blogs.
vs MediaWiki
Outline gana: UI moderno, más amigable, mejor UX. MediaWiki gana: Hyper-flexible, comunidad masiva.
Comentarios
Publicar un comentario