Vídeo tutorial en YouTube

Mira el vídeo completo sobre cómo instalar y usar Vikunja: El gestor de tareas que realmente posees en el canal GENBYTE:

¿Qué es Vikunja: El gestor de tareas que realmente posees?

Vikunja es un gestor de tareas y proyectos de código abierto desarrollado en Go con frontend en Vue.js. Su filosofía central es que el usuario tenga propiedad total sobre sus datos, ofreciendo una alternativa autoalojada a servicios como Todoist, Asana o Trello. El proyecto está licenciado bajo AGPL-3.0-or-later, lo que garantiza que las modificaciones en despliegues de red permanezcan abiertas. Cuenta con una instancia de prueba pública en try.vikunja.io, una versión alojada gestionada en vikunja.cloud y una edición Pro con características adicionales como panel de administración, registros de auditoría y seguimiento de tiempo.

Características principales

Requisitos del sistema

• Docker Engine 20.10+ o Docker Compose v2+ para despliegue en contenedor
• Puerto 3456 TCP accesible para la interfaz web y API
• Volumen persistente para la base de datos SQLite (ruta por defecto /db/vikunja.db) o servidor PostgreSQL/MySQL externo
• Mínimo 512 MB RAM y 1 vCPU para instancias pequeñas; 1 GB+ RAM recomendado para uso en equipo
• Sistema de archivos con soporte para permisos de usuario 1000:1000 (UID/GID del contenedor)

Instalación con Docker Compose

Despliegue con Docker (imagen oficial)

La imagen oficial se publica en Docker Hub como vikunja/vikunja. El Dockerfile multi-etapa compila el frontend (Node.js 24, pnpm, Vue.js) y el backend (Go 1.27, Mage) en una imagen final scratch que expone el puerto 3456 y ejecuta el binario como usuario 1000. No se encontró un archivo docker-compose.yml en el repositorio principal; la documentación oficial en vikunja.io/docs/installing/ proporciona ejemplos completos con bases de datos externas, proxy inverso y variables de entorno.

Compilación desde código fuente

El repositorio incluye un Magefile para automatizar la compilación. Requiere Go 1.27+, Node.js 24+ y pnpm. El proceso compila el frontend, incrusta los assets en el binario Go y genera ejecutables multiplataforma mediante xgo.

Acceder al proyecto

Interfaz web y API

Tras iniciar el contenedor, la aplicación está disponible en http://<host>:3456. La API REST v2 se sirve bajo /api/v2 y su documentación Swagger en /api/v2/docs. El primer acceso muestra un asistente de configuración inicial para crear el usuario administrador y definir ajustes básicos.

Casos de uso

• Gestión personal de tareas y proyectos con control total de privacidad
• Colaboración en equipos pequeños y medianos que requieren autoalojamiento por cumplimiento normativo
• Sustitución de SaaS de productividad (Todoist, Asana, Trello) manteniendo la soberanía de datos
• Integración con flujos de trabajo existentes mediante API REST y webhooks
• Entornos educativos o asociaciones que necesitan una herramienta gratuita y sin límites de usuarios

Configuración avanzada

Variables de entorno principales

El contenedor expone variables para configuración sin archivo YAML. Las más relevantes según el Dockerfile y la documentación oficial: VIKUNJA_SERVICE_ROOTPATH (ruta base si se sirve bajo subpath), VIKUNJA_DATABASE_PATH (ruta del archivo SQLite), VIKUNJA_DATABASE_TYPE (sqlite, postgres, mysql), VIKUNJA_SERVICE_JWTSECRET (clave para tokens JWT), VIKUNJA_SERVICE_PUBLICURL (URL pública para enlaces en correos), VIKUNJA_CORS_ENABLED y VIKUNJA_CORS_ORIGINS para CORS.

Configuración mediante archivo YAML

Para configuraciones complejas se recomienda montar un archivo config.yml en /app/vikunja/config.yml. El archivo permite definir base de datos, correo SMTP, caché (Redis), colas, métricas Prometheus, logging, rate limiting, y ajustes de frontend. La estructura completa está documentada en config-raw.json del repositorio y en la guía de configuración oficial.

Uso con base de datos externa (PostgreSQL)

Para producción con alta concurrencia se recomienda PostgreSQL. Requiere crear la base de datos y usuario, y configurar las variables de conexión. El contenedor ejecuta migraciones automáticas al inicio.

Gestión y mantenimiento

Actualización de versión

Actualizar la imagen y recrear el contenedor preservando los volúmenes de datos y configuración. Las migraciones de base de datos se aplican automáticamente al arranque.

Copia de seguridad

La base de datos SQLite (/db/vikunja.db) y el directorio de archivos adjuntos (configurable, por defecto en /app/vikunja/files) deben incluirse en las copias de seguridad. Para PostgreSQL/MySQL usar herramientas nativas (pg_dump, mysqldump).

Logs y monitorización

Los logs se escriben en stdout/stderr en formato JSON configurable. Se pueden recopilar con Loki, Elasticsearch o journalctl. La aplicación expone métricas Prometheus en /metrics si se habilita en configuración.

Stack técnico

• Go 1.27 (backend)
• Vue.js 3 (frontend)
• Node.js 24 / pnpm (build frontend)
• Mage (automatización de build)
• xgo (compilación cruzada Go)
• SQLite / PostgreSQL / MySQL (base de datos)
• Docker (imagen multi-etapa scratch)
• AGPL-3.0-or-later (licencia principal)
• GPL-3.0-or-later (cliente de escritorio)

Apoya el canal GENBYTE

Sígueme en mis redes sociales