Vikunja en Docker: gestor de tareas ligero con fechas límite, notas y checklists

🐳 Docker · ✅ Gestor de tareas · 🏠 Self-Host

Vikunja en Docker: gestor de tareas ligero con fechas límite, notas y checklists

Una alternativa mucho más ligera que OpenProject para tu homelab: listas, Kanban, calendario, recordatorios y todo en un único contenedor con SQLite.

🎬 Vídeo en el canal

Te lo cuento paso a paso en el canal. Haz clic en la miniatura para verlo en YouTube:

Vikunja en Docker - vídeo de GENBYTE

https://youtu.be/MYvLmPzhUlQ

¿Qué es Vikunja?

Vikunja es un gestor de tareas y proyectos de código abierto y autohospedado. Está escrito en Go, así que funciona con muy pocos recursos y se despliega en un solo contenedor. Si te pasaba como a mí con OpenProject (potente, pero pesado para un homelab), Vikunja es una lista de tareas con superpoderes: apuntas cosas con fecha límite, les añades notas y checklists, y listo.

✨ Características

📅 Fechas límiteFecha de inicio y de vencimiento, con prioridad por tarea.
⏰ RecordatoriosAbsolutos o relativos al vencimiento. Por email si configuras SMTP.
📝 Notas y checklistsDescripción en Markdown con listas - [ ] que se marcan con un clic.
🗂️ Varias vistasLista, Kanban, tabla, Gantt y calendario sobre los mismos datos.
🏷️ Etiquetas y filtrosFiltros guardados como "vence esta semana" que aparecen en la barra lateral.
🔁 Tareas repetitivasIdeal para mantenimiento del homelab: backups, actualizaciones, certificados.
📎 Adjuntos y comentariosGuarda capturas, configs o logs dentro de cada tarea.
🪶 Muy ligeroUn contenedor con SQLite. Puedes migrar a PostgreSQL si creces.

📋 Requisitos

  • Un servidor o Raspberry Pi con Docker y Docker Compose.
  • El puerto 3456 libre (o el que prefieras).
  • Opcional: un proxy inverso con dominio y HTTPS si vas a acceder desde fuera.

🐳 Instalación con Docker Compose

1. Crea las carpetas y el compose

mkdir -p vikunja/files vikunja/db
cd vikunja
nano docker-compose.yml

2. Mi docker-compose.yml

services:
  vikunja:
    image: vikunja/vikunja:latest
    container_name: vikunja
    restart: unless-stopped
    environment:
      VIKUNJA_SERVICE_PUBLICURL: http://TU_IP:3456/
      VIKUNJA_DATABASE_TYPE: sqlite
      VIKUNJA_DATABASE_PATH: /db/vikunja.db
      VIKUNJA_SERVICE_JWTSECRET: cambia-esto-por-un-secreto-largo
      VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"
    ports:
      - "3456:3456"
    volumes:
      - ./files:/app/vikunja/files
      - ./db:/db
💡 Cambia estos valores: sustituye TU_IP por la IP o el dominio de tu servidor y genera un JWTSECRET largo y aleatorio (por ejemplo con openssl rand -hex 32). Con un proxy inverso, pon ahí la URL pública.

3. Arranca el contenedor

docker compose up -d
docker compose logs -f vikunja
⚠️ Error de permisos: si en los logs ves mkdir /app/vikunja/files/.tmp: permission denied, es que el contenedor corre como uid=1000 y las carpetas las creó root. Solución:
docker compose down
sudo chown -R 1000:0 ./files ./db
docker compose up -d

🌐 Acceder a Vikunja

Abre http://TU_IP:3456 en el navegador. Como el registro público está desactivado en mi compose (VIKUNJA_SERVICE_ENABLEREGISTRATION: "false"), los usuarios se crean por línea de comandos. Para eso tengo el siguiente script.

👤 Script para gestionar usuarios

Un pequeño menú en bash que usa docker exec para listar, crear y borrar usuarios del contenedor vikunja.

#!/bin/bash

CONTAINER="vikunja"
BIN="/app/vikunja/vikunja"
LINE="------------------------------------------"

vk() {
    docker exec -i "$CONTAINER" "$BIN" "$@"
}

list_users() {
    echo "$LINE"
    echo -e "\e[0;32mUser list:\e[00m"
    vk user list
}

create_user() {
    read -rp "Enter the username: " username
    read -rsp "Enter the password: " password
    echo
    read -rp "Enter the email address: " email

    vk user create -e "$email" -p "$password" -u "$username"
}

delete_user() {
    list_users
    read -rp "Enter the ID of the user you want to delete: " userID

    # Con -c -n borra directamente, sin confirmación
    vk user delete "$userID" -c -n
}

main() {
    while true; do
        echo "$LINE"
        echo -e "\e[0;32mWhat action would you like to perform?\e[00m"
        echo "1. List users"
        echo "2. Create user"
        echo "3. Delete user"
        echo "4. Exit"
        echo "$LINE"

        read -rp "Enter the number of the action you want to perform: " option

        case $option in
            1) list_users ;;
            2) create_user ;;
            3) delete_user ;;
            4) echo -e "\e[0;32mExiting.\e[00m"; exit 0 ;;
            *) echo "Invalid option. Please select a valid option." ;;
        esac
    done
}

main

Guárdalo como vikunja-users.sh, dale permisos y ejecútalo:

chmod +x vikunja-users.sh
./vikunja-users.sh
⚠️ Ten en cuenta: el borrado de usuarios es destructivo y no se puede deshacer. Además, la contraseña se pasa con -p, así que queda visible un instante en la lista de procesos del host. En un homelab personal no es grave, pero conviene saberlo.

🎯 Casos de uso

  • Mantenimiento del homelab: tareas repetitivas para revisar backups, actualizar contenedores o renovar certificados.
  • Contenido: un proyecto por vídeo o post, con checklist de pasos y fecha de publicación.
  • Día a día: lista personal con filtros como "vence esta semana".

🛠️ Gestión y mantenimiento

  • Backup: copia periódica de ./db y ./files (un rsync o tar programado basta).
  • Actualizar: docker compose pull && docker compose up -d. Lee antes las notas de versión y, si prefieres estabilidad, fija una versión concreta en lugar de latest.
  • Móvil: puedes instalar la web como PWA desde el navegador.
  • Automatización: Vikunja tiene API y webhooks, útiles para integrarlo con n8n.

🧰 Stack técnico

ComponenteTecnología
BackendGo
FrontendVue.js
Base de datosSQLite (por defecto), PostgreSQL o MySQL
DespliegueDocker / Docker Compose

⚖️ Comparativa con otras alternativas

HerramientaEnfoquePeso aproximado
VikunjaTareas + varias vistasMuy ligero
PlankaKanban estilo TrelloMedio (necesita PostgreSQL)
KanboardKanban minimalistaMuy ligero
PlaneGestión de proyectos modernaPesado
OpenProjectGestión de proyectos completaPesado

📚 Referencias oficiales

❤️ Apoya el canal: si te ha servido, suscríbete al canal, deja tu like en el vídeo y comparte el post. ¡Ayuda muchísimo a seguir creando contenido sobre homelab y self-hosting!

🌍 Sígueme en redes

Comentarios

Entradas populares de este blog

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

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

Solución al Error "No se encontró la imagen de Windows RE" en Windows 10 al ejecutar reagentc /enable