Vikunja en Docker: gestor de tareas ligero con fechas límite, notas y checklists
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:
¿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
- [ ] que se marcan con un clic.📋 Requisitos
- Un servidor o Raspberry Pi con Docker y Docker Compose.
- El puerto
3456libre (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
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
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
-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
./dby./files(unrsyncotarprogramado 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 delatest. - 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
| Componente | Tecnología |
|---|---|
| Backend | Go |
| Frontend | Vue.js |
| Base de datos | SQLite (por defecto), PostgreSQL o MySQL |
| Despliegue | Docker / Docker Compose |
⚖️ Comparativa con otras alternativas
| Herramienta | Enfoque | Peso aproximado |
|---|---|---|
| Vikunja | Tareas + varias vistas | Muy ligero |
| Planka | Kanban estilo Trello | Medio (necesita PostgreSQL) |
| Kanboard | Kanban minimalista | Muy ligero |
| Plane | Gestión de proyectos moderna | Pesado |
| OpenProject | Gestión de proyectos completa | Pesado |
Comentarios
Publicar un comentario