Vikunja Docker Compose: Gestor de Tareas Self-Hosted 2026

Vikunja Docker Compose es la forma más sencilla de montar tu propio gestor de tareas y listas self-hosted, potente y privado. Con esta aplicación organizas tu vida y tus proyectos en listas, tableros kanban, vistas de calendario y diagramas de Gantt, todo bajo tu control y sin que ninguna empresa analice tus pendientes. En esta guía la desplegarás con Docker, la conectarás a una base de datos y la publicarás con HTTPS.

¿Qué es Vikunja y por qué usar Docker Compose?

Vikunja Docker Compose despliega un gestor de tareas de código abierto que destaca por su flexibilidad: la misma tarea puede verse como una lista simple, un tablero kanban, una entrada de calendario o una barra en un diagrama de Gantt. Escrito en Go, es rápido y ligero, y reúne en una sola herramienta la organización personal y la gestión de proyectos en equipo. Al desplegarlo con Docker, obtienes una instalación reproducible y fácil de mantener.

Autohospedar tu gestor de tareas con esta solución aporta ventajas claras frente a las apps comerciales:

• Privacidad: tus tareas y proyectos, a menudo información sensible, no salen de tu servidor.
• Múltiples vistas: lista, kanban, tabla, calendario y Gantt para adaptarse a cómo piensas.
• Trabajo en equipo: comparte proyectos, asigna tareas y colabora con permisos granulares.
• Sin límites: crea todos los proyectos y tareas que quieras, sin planes de pago.

Vikunja Docker Compose encaja muy bien junto a otras herramientas de productividad self-hosted. Si buscas una gestión de proyectos más orientada a tableros, complementa lo que vimos en Planka para kanban, mientras que Vikunja brilla cuando necesitas combinar varias vistas sobre las mismas tareas.

Requisitos previos para Vikunja Docker Compose

Antes de desplegar Vikunja Docker Compose, prepara lo básico. El consumo de recursos es mínimo, así que casi cualquier servidor sirve.

• Un servidor con Docker Engine y Docker Compose v2.
• Acceso por terminal con usuario en el grupo docker o con sudo.
• Unos 512 MB de RAM libres; Vikunja es muy eficiente.
• Recomendado: un dominio y un proxy inverso para servirla con HTTPS.

Para la publicación segura te resultará útil nuestra guía de Caddy con HTTPS automático, que usaremos para que Vikunja sea accesible de forma cifrada desde cualquier dispositivo.

Instalar Vikunja Docker Compose paso a paso

Creamos el directorio del proyecto donde vivirán el fichero de composición y los datos persistentes.

mkdir -p ~/docker/vikunja && cd ~/docker/vikunja

Crea el fichero docker-compose.yml. Las versiones modernas de Vikunja unifican el backend y el frontend en una sola imagen, lo que simplifica mucho el despliegue. Usamos PostgreSQL como base de datos para un rendimiento sólido.

services:
  vikunja:
    image: vikunja/vikunja:latest
    container_name: vikunja
    restart: unless-stopped
    depends_on:
      - vikunja_db
    environment:
      VIKUNJA_SERVICE_PUBLICURL: https://tareas.tudominio.com
      VIKUNJA_DATABASE_TYPE: postgres
      VIKUNJA_DATABASE_HOST: vikunja_db
      VIKUNJA_DATABASE_USER: vikunja
      VIKUNJA_DATABASE_PASSWORD: cambia-esta-clave
      VIKUNJA_DATABASE_DATABASE: vikunja
    ports:
      - "3456:3456"
    volumes:
      - ./files:/app/vikunja/files

  vikunja_db:
    image: postgres:16-alpine
    container_name: vikunja-db
    restart: unless-stopped
    environment:
      POSTGRES_USER: vikunja
      POSTGRES_PASSWORD: cambia-esta-clave
      POSTGRES_DB: vikunja
    volumes:
      - ./db:/var/lib/postgresql/data

La variable VIKUNJA_SERVICE_PUBLICURL es crucial: debe coincidir exactamente con la URL final por la que accederás, ya que Vikunja la usa para construir enlaces. Levanta el stack y comprueba que ambos contenedores arrancan correctamente.

docker compose up -d
docker compose ps

Con los servicios en marcha, Vikunja Docker Compose escuchará en el puerto 3456. Abre http://IP-DEL-SERVIDOR:3456 en el navegador y verás la pantalla de registro, donde crearás tu cuenta de usuario.

Publicar Vikunja Docker Compose con HTTPS

Para acceder a tu gestor de tareas desde cualquier lugar y desde el móvil de forma segura, publícalo con HTTPS a través de un proxy inverso. Si usas Caddy, el bloque de configuración es mínimo: apunta tu subdominio al puerto que publicamos.

tareas.tudominio.com {
    reverse_proxy localhost:3456
}

Caddy gestionará automáticamente el certificado TLS de Let’s Encrypt, dejando https://tareas.tudominio.com accesible y cifrado. Recuerda que la URL pública del proxy debe coincidir con la variable VIKUNJA_SERVICE_PUBLICURL que configuramos; si no, algunos enlaces internos no funcionarán. Si prefieres una interfaz gráfica para gestionar tus dominios, también puedes usar Nginx Proxy Manager.

Organizar tus tareas en Vikunja Docker Compose

La gran fortaleza de Vikunja Docker Compose es la flexibilidad para visualizar tus tareas de distintas formas según lo que necesites en cada momento. Sobre un mismo proyecto puedes alternar entre varias vistas sin duplicar nada.

• Lista: la vista clásica de tareas pendientes, ideal para el día a día.
• Kanban: tableros con columnas para seguir el flujo de trabajo de un vistazo.
• Calendario: ubica las tareas con fecha de vencimiento en el tiempo.
• Gantt: visualiza la duración y las dependencias de un proyecto completo.

Además de las vistas, Vikunja ofrece funciones que enriquecen la organización: etiquetas de colores, subtareas, recordatorios, prioridades, campos personalizados y asignación a miembros del equipo. Puedes empezar con una lista simple e ir adoptando funciones más avanzadas a medida que tus necesidades crecen, sin sentirte abrumado desde el principio.

Sincronización y trabajo en equipo

Vikunja Docker Compose no se limita a la interfaz web. Soporta el estándar CalDAV, lo que te permite sincronizar tus tareas con calendarios de tu móvil o tu ordenador, y cuenta con aplicaciones móviles para acceder a tus pendientes desde cualquier lugar. Esta apertura a los estándares evita que quedes atrapado en un ecosistema cerrado.

Para los equipos, Vikunja permite crear proyectos compartidos, organizar el trabajo en carpetas y asignar tareas con distintos niveles de permiso. Cada miembro ve lo que le corresponde, y el responsable mantiene una visión global del avance mediante las vistas de kanban o Gantt. Esta combinación de organización personal y colaborativa en una sola herramienta es lo que hace de Vikunja Docker Compose una opción tan versátil, capaz de crecer contigo desde una lista de la compra hasta la gestión de un proyecto complejo con varias personas implicadas.

Casos de uso reales de Vikunja Docker Compose

Para apreciar la versatilidad de esta herramienta, veamos cómo distintas personas aprovechan Vikunja Docker Compose en su día a día. Su capacidad de mostrar las mismas tareas de formas diferentes la hace útil en escenarios muy variados:

• Organización personal: listas de la compra, recados y objetivos, con recordatorios para no olvidar nada.
• Gestión de proyectos: un equipo sigue el avance con tableros kanban y planifica plazos con la vista Gantt.
• Estudios: un estudiante organiza entregas y exámenes en el calendario, con etiquetas por asignatura.
• Trabajo autónomo: un freelance separa proyectos por cliente y controla las tareas facturables.

La clave es que una misma instalación de Vikunja Docker Compose sirve para todos estos casos a la vez, adaptándose a cada contexto sin obligarte a cambiar de aplicación. Empiezas con lo básico y vas descubriendo funciones a medida que las necesitas, sin la curva de aprendizaje abrumadora de las suites de gestión de proyectos más pesadas. Esa progresión natural es una de las razones por las que tantos usuarios acaban adoptándola como su herramienta central de productividad.

Vikunja frente a otras apps de tareas

El mercado de los gestores de tareas está lleno de opciones comerciales como Todoist, Asana o Trello, muy pulidas pero con un coste importante: tus datos viven en sus servidores y las funciones avanzadas suelen estar tras un muro de pago. Vikunja Docker Compose plantea una alternativa que invierte esa ecuación, poniendo el control y la privacidad en primer lugar.

Frente a esas plataformas, la propuesta de valor del autohospedaje es clara. Tus tareas, que a menudo revelan información muy personal sobre tu vida y tu trabajo, permanecen en tu servidor y no alimentan ningún perfil publicitario. No hay límites artificiales en el número de proyectos ni funciones reservadas a planes premium, porque todo el potencial de la aplicación está disponible desde el primer día. Y al basarse en estándares abiertos como CalDAV, evitas el bloqueo de proveedor que hace tan doloroso migrar de una app comercial a otra. A cambio, asumes el mantenimiento del servidor, un compromiso menor gracias a la ligereza de Vikunja. Para quien valora la independencia digital y ya gestiona otros servicios self-hosted, la elección resulta natural y coherente con esa filosofía.

Mantenimiento y solución de problemas

• Enlaces rotos o errores de acceso: revisa que VIKUNJA_SERVICE_PUBLICURL coincide con la URL real del proxy.
• Copias de seguridad: respalda el volumen de la base de datos y la carpeta de ficheros adjuntos.
• No puedes registrarte: si desactivaste el registro público, crea usuarios desde la administración.
• Actualizar: cambia la etiqueta de la imagen, haz docker compose pull y up -d.

La mayoría de los problemas de Vikunja Docker Compose están relacionados con la URL pública o con la base de datos, así que revisa esas dos piezas primero. Descubre más servicios para tu servidor en nuestra categoría de tutoriales de Docker Compose.

Conclusión

Montar Vikunja Docker Compose te da un gestor de tareas potente, flexible y totalmente privado, capaz de adaptarse tanto a tu organización personal como al trabajo en equipo. Hemos cubierto el despliegue con PostgreSQL, la configuración de la URL pública, la publicación segura con HTTPS y el aprovechamiento de sus múltiples vistas. A partir de aquí, crea tus proyectos, prueba las vistas kanban y Gantt, y recupera el control de tu productividad sin ceder tus datos a nadie.

Como recorrido recomendado, empieza migrando un único ámbito de tu vida —por ejemplo, tus tareas del trabajo— para acostumbrarte a la herramienta sin la presión de moverlo todo de golpe. Prueba las distintas vistas sobre ese mismo proyecto hasta descubrir cuál se ajusta mejor a tu forma de pensar, porque ese hallazgo es el que de verdad transforma tu organización. Después, incorpora poco a poco el resto de áreas y, si trabajas en equipo, invita a tus compañeros a un proyecto compartido para experimentar la colaboración en tiempo real. No olvides configurar la sincronización con el calendario de tu móvil mediante CalDAV: tener tus tareas siempre a mano, incluso sin abrir la aplicación, marca una diferencia enorme en la constancia. Y, como con cualquier servicio autohospedado, programa copias de seguridad automáticas de la base de datos, porque tu sistema de organización solo es fiable si sabes que nunca perderás lo que has planificado. Con estos hábitos, Vikunja se convertirá en el centro tranquilo desde el que gobiernas tu tiempo.

Preguntas frecuentes sobre Vikunja Docker Compose

¿Vikunja necesita base de datos externa?

Puede funcionar con SQLite sin configuración adicional, ideal para pruebas. Para un uso serio o en equipo, PostgreSQL o MySQL ofrecen mejor rendimiento, como en el ejemplo de esta guía.

¿Tiene aplicación móvil?

Sí, Vikunja dispone de aplicaciones móviles y además soporta CalDAV, lo que te permite sincronizar tus tareas con las apps de calendario de tu teléfono de forma nativa.

¿Puedo usarlo en equipo?

Sí. Vikunja permite compartir proyectos, asignar tareas y gestionar permisos por usuario o equipo, combinando la organización personal con la colaboración en un mismo lugar.

¿Vikunja es gratis?

Sí, Vikunja es un proyecto de código abierto y gratuito. Solo asumes el coste del servidor donde lo alojes, que para uso personal es muy contenido.

Fuentes y recursos oficiales

• Sitio oficial de Vikunja
• Documentación oficial de Vikunja
• Vikunja en GitHub
• Imagen oficial en Docker Hub
• Documentación de Docker Compose