Cómo instalar Vikunja en Docker - Task Manager autohospedado

Vikunja | Task Manager | Go + Vue.js | Self-hosted | Kanban | Gantt | CalDAV | Multi-user | Open source | AGPL-3.0 | 13k+ stars

Vikunja en Docker: Task manager autohospedado Go + Vue.js con kanban, gantt, calendar, teams, CalDAV provider, webhooks, API REST, multiple databases, multi-platform (x86/ARM), 13k+ stars, AGPL-3.0 open source, production-ready ✅📋

Vikunja es un gestor de tareas completamente autohospedado, open source y multi-plataforma construido con Go (backend) + Vue.js (frontend). Kanban boards, Gantt charts, Calendar view, Teams collaboration, CalDAV provider (sync con Thunderbird/Outlook), API REST completa, Webhooks, import/export iCal, subtasks, labels, attachments, notifications, due dates, reminders, recurring tasks, multiple databases (SQLite, MySQL, PostgreSQL), multi-user authentication, self-hosted sin vendor lock-in, 13k+ GitHub stars, AGPL-3.0 open source, Docker ready, production-ready, escalable horizontalmente.



Vídeo tutorial en YouTube

Mira el vídeo completo sobre cómo instalar y usar Vikunja en Docker en el canal GENBYTE:

🐳 </> GENBYTE Homelab • Docker • Self-Hosting 🐳 Docker 📂 Opensource 🏠 Self-Host Suscríbete al canal GENBYTE

Clickea la miniatura para ir a YouTube →

¿Qué es Vikunja en Docker?

Vikunja es un gestor de tareas completamente autohospedado, open source y multi-plataforma construido con Go (backend) + Vue.js (frontend) que proporciona múltiples vistas (kanban boards, gantt charts, calendar, list view), colaboración en equipo (teams, projects, namespaces), CalDAV provider (sincroniza con Thunderbird, Outlook, iCal), API REST completa (OpenAPI docs), Webhooks para integraciones, import/export iCal, subtasks, labels, attachments, notificaciones, due dates, reminders, recurring tasks, múltiples bases de datos (SQLite, MySQL, PostgreSQL), autenticación multi-usuario, sin vendor lock-in, completamente privado, 13k+ GitHub stars, AGPL-3.0 open source, Docker ready, production-ready, escalable horizontalmente. El gestor de tareas que pedías con colaboración real.

Propuesta clave: Open-source task manager (Go + Vue.js). Multiple views (kanban, gantt, calendar, list). Team collaboration (projects, namespaces, sharing). CalDAV provider. REST API (OpenAPI). Webhooks. Subtasks. Labels. Attachments. Notifications. Due dates. Reminders. Recurring. Multiple databases. Self-hosted. Private. 13k+ stars. AGPL-3.0. Docker. Production-ready.

Para homelabs: Open-source task manager. Multi-view. Team collaboration. CalDAV. API. Self-hosted. Private data.

Características principales

Kanban boards

Drag-drop tasks. Custom columns. Swimlanes. Card templates.

Gantt charts

Timeline visualization. Task dependencies. Milestones. Critical path.

Calendar view

Day/week/month. Due dates. Reminders. Multi-task days.

Teams & Projects

Multiple teams. Namespaces. Projects. Sharing permissions granular.

CalDAV provider

Sync con Thunderbird, Outlook, iCal. Two-way sync. Standards.

REST API

OpenAPI docs. Full API. Webhooks. Custom integrations.

Subtasks

Task hierarchy. Nested subtasks. Progress tracking. Dependencies.

Labels & Tags

Custom labels. Color coding. Filtering. Multi-select.

Attachments

Upload files. Images. Documents. In-task access.

Notifications

Email alerts. In-app notifications. Customizable. Subscriptions.

Recurring tasks

Recurring patterns. Daily, weekly, monthly, custom. Auto-create.

Comments & Activity

Task discussion. Activity log. Mentions. @ notifications.

Requisitos del sistema

  • Docker & Docker Compose v2+
  • 512 MB - 2 GB RAM mínimo (recomendado 2GB+ para equipos grandes)
  • 1 GB - 50GB+ espacio disco (según datos tareas)
  • Puerto TCP: 3456 (web UI, configurable)
  • Database: SQLite (embedded) OR MySQL 5.7+ OR PostgreSQL 10+
  • Multi-plataforma: Linux, Windows, macOS
  • Multi-arch: amd64, arm64, armv7
  • Opcional: Reverse proxy nginx/Caddy para HTTPS + dominio
⚠️ AGPL-3.0 License: Copyleft obligations. Modificaciones o deployments publicos deben ser open source. Revisar licencia antes de producción.
💡 Requisitos moderados: Más heavy que Vikunja alternative (Taiga), pero menos que Jira. Bueno para equipos pequeños-medianos.

Instalación con Docker Compose

Paso 1: docker-compose.yml (simple con PostgreSQL)

version: '3.8' services: vikunja: image: vikunja/vikunja:latest container_name: vikunja restart: unless-stopped ports: - "3456:3456" volumes: - ./files:/app/vikunja/files environment: - VIKUNJA_DATABASE_TYPE=postgres - VIKUNJA_DATABASE_HOST=db - VIKUNJA_DATABASE_PORT=5432 - VIKUNJA_DATABASE_USER=vikunja - VIKUNJA_DATABASE_PASSWORD=securepass123 - VIKUNJA_DATABASE_DATABASE=vikunja depends_on: - db db: image: postgres:15 container_name: vikunja-db restart: unless-stopped environment: - POSTGRES_DB=vikunja - POSTGRES_USER=vikunja - POSTGRES_PASSWORD=securepass123 volumes: - db_data:/var/lib/postgresql/data volumes: db_data:

Paso 2: Iniciar Vikunja

docker compose up -d # Espera ~20 segundos para que inicie (migration DB) docker compose logs -f

Paso 3: Acceder a Vikunja

# Abre en navegador: http://localhost:3456 # Desde otro dispositivo: http://192.168.1.100:3456

Acceder a Vikunja

✅ Vikunja Web UI: http://localhost:3456
📋 API REST: http://localhost:3456/api/v1
📅 CalDAV URL: http://localhost:3456/dav

Primeros pasos

  1. Abre http://localhost:3456 en navegador
  2. Click "Register" para crear usuario admin
  3. Ingresa email y contraseña
  4. Login con credenciales
  5. Dashboard aparece con proyectos vacíos
  6. Create nuevo proyecto (namespace → project)
  7. Agrega tareas en kanban board
  8. Invita colaboradores si es equipo
💡 First user = admin: El primer usuario registrado obtiene permisos admin.

Casos de uso

  • Team project management: Equipos pequeños-medianos. Task tracking. Multiple projects.
  • CalDAV sync: Sincroniza con Thunderbird, Outlook. Unified task calendar.
  • Agile/Kanban workflow: Kanban boards. Sprint planning. Gantt charts.
  • Personal + team: Proyectos personales. Proyectos compartidos. Namespaces.
  • API integrations: REST API. Webhooks. Custom tools. n8n automation.
  • Enterprise self-hosted: Full data control. Custom deployment. No vendor lock-in.
  • Privacy-focused: Self-hosted. AGPL guarantees. Community-driven.

Configuración avanzada

Usar SQLite (ligero, single-user)

# docker-compose.yml simplificado VIKUNJA_DATABASE_TYPE=sqlite VIKUNJA_DATABASE_SQLITE_FILE=/app/vikunja/vikunja.db # No requiere DB service separado

Habilitar HTTPS con Caddy

# Agregar service caddy al docker-compose.yml caddy: image: caddy:latest ports: - "80:80" - "443:443" volumes: - ./Caddyfile:/etc/caddy/Caddyfile - caddy_data:/data

Webhooks para integraciones

# Admin Panel → Settings → Webhooks # Configure eventos: task.created, task.updated, task.deleted # POST to your webhook URL (n8n, Zapier, custom app)

Migrate desde Todoist/Asana

# Vikunja soporta import iCal/CSV # Exporta from Todoist as iCal # Admin Panel → Tools → Import # Selecciona iCal file

Gestión y mantenimiento

Ver estado

docker compose ps

Ver logs

docker compose logs -f vikunja # Ver también DB logs docker compose logs -f db

Detener Vikunja

docker compose down

Actualizar versión

docker compose pull docker compose up -d # DB migration ocurre automáticamente

Backup de datos

docker compose exec db pg_dump -U vikunja vikunja > backup.sql # Backup carpeta files tar -czf vikunja_files_backup.tar.gz files/

Monitorear consumo

docker stats vikunja db # Típicamente: # Vikunja CPU: 2-10% (según uso) # Vikunja RAM: 100-500MB # PostgreSQL RAM: 200-1GB

Stack técnico

  • Backend: Go (Golang, REST API, OpenAPI)
  • Frontend: Vue.js 3 (TypeScript, Vite)
  • Database: SQLite (default) / MySQL 5.7+ / PostgreSQL 10+
  • API: REST API (OpenAPI 3.0 docs)
  • Authentication: JWT tokens, OAuth2 (optional)
  • Features: Kanban, Gantt, Calendar, CalDAV provider
  • Webhooks: Event-driven integrations
  • Multi-platform: Linux, Windows, macOS
  • Deployment: Docker, Docker Compose, Kubernetes-ready
  • Licencia: AGPL-3.0 (copyleft)

Comparativa con alternativas

vs Plane

Vikunja gana: CalDAV, Gantt charts, más maduro, comunidad grande. Plane gana: UI más modern, GitHub integration, issue tracking, roadmap features.

vs OpenProject

Vikunja gana: Más simple, lightweight, fácil deploy. OpenProject gana: Enterprise features, time tracking, cost management, Gantt avanzado.

vs Focalboard

Vikunja gana: CalDAV, Gantt nativo, más vistas. Focalboard gana: Mattermost integration, Kanban boards más flexible, database view.

Mejor para: Teams pequeños-medianos, self-hosted, open source preference. Gantt charts. CalDAV sync. AGPL ok.

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter

Comentarios

Publicar un comentario

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Imagen
Wireguard en Mikrotik Breve Explicación de Wireguard ¿Qué es WireGuard VPN? WireGuard es un nuevo protocolo de VPN. No se trata de un software, sino de un conjunto de instrucciones que permite crear VPNs de forma muy sencilla. Ha sido desarrollada como una alternativa a IPsec, OpenVPN y similares VPNs, pero más rápida y sencilla de usar. En esencia, WireGuard está basado en ideas del protocolo IPsec. WireGuard es una VPN extremadamente simple, pero rápida y moderna que utiliza criptografía de última generación. Su objetivo es ser más rápido, más simple, y más versátil que IPSec, evitando al mismo tiempo el enorme dolor de cabeza (sobre todo en redes con NAT). Pretende ser considerablemente más eficaz que OpenVPN. WireGuard está diseñado como una VPN de propósito general para ejecutarse en interfaces embebidas, apto para muchas circunstancias diferentes. Se ejecuta sobre el protocolo UDP, por lo tanto es considerado un túnel de capa 3. ¿Cómo funciona Wireguard VPN? WireGuard es un proto...
Read more »

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Imagen
Instalación y puesta en marcha de Synology DSM 7.2.2 en PC Vídeo ACTUALIZADO, NUEVA VERSIÓN DEL ARC LOADER:  https://youtu.be/LgghogL-UCA https://genbyte.blogspot.com/2025/08/como-convertir-pc-en-synlogy-con-6-tb.html ----- Proceso de instalación y puesta en marcha de sistema operativo DSM Synology versión 7.2.2 en un PC, concretamente un HP 800 G1 EliteDesk. El PC tendrá 3 discos SSD, uno de 120 GB para el S.O. DSM, y otros dos de 240GB cada en RAID 1 para los Datos. Los 3 dicos duros conectados al PC mediante cables SATA. Lo primero que necesitamos es descargar la imagen bootloader ARC, desde el siguiente repositorio de Gothub, también necesitamos Rufus, en este momento, es la versión 4.6. Imagen ARC:  https://github.com/AuxXxilium/arc Imagen usado en el vídeo 1.1.29:  https://github.com/AuxXxilium/arc/releases/tag/1.1.29 Rufus:  https://rufus.ie/es/ Después de descargar la imagen ARC.img, conectamos nuestro primer disco SSD de 120GB por cable o conector SATA-USB y...
Read more »

Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso.

Imagen
Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso. Vídeo tutorial paso a paso en Youtube Desarrollo Ilustración: Diagrama RED Creación de Redes (Address) ----------------------------------------------- WAN 192.168.1.0/24 LAN 192.168.88.0/24 VPN 192.168.100.0/24 Creación del Rango VPN ------------------------ 192.168.100.1 - 192.168.100.100 Creación de los Certificados ------------------------------- Los certificados que vamos a crear a continuación tendrán una validez de 10 años; days-valid=3650 Crear certificado CA ---------------------- /certificate add name=CA-tpl country="" state="" locality="" organization="" unit="" common-name="CA" key-size=4096 days-valid=3650 key-usage=crl-sign,key-cert-sign /certificate sign CA-tpl ca-crl-host=127.0.0.1 name="CA" Crear certificado Server -------------------------- /certificate add name=SERVER-tpl country="" state="" locality=...
Read more »