Alojar Kaneo en un VPS: gestión de proyectos open source ligera

Las herramientas SaaS de gestión de proyectos tienden a engordar: cada actualización añade una vista, un informe o un módulo de IA que ahoga las funciones esenciales. Kaneo parte de la hipótesis contraria: la mayoría de los equipos solo necesita un Kanban y un vínculo con su repositorio de código. Al autoalojarlo, usted recupera el control total — sus tareas en una base de datos PostgreSQL en su VPS, exportables como SQL en cualquier momento, sin plan premium para desbloquear los webhooks o el historial ilimitado.

Un VPS ServOrbit con Ubuntu 24.04 y al menos 1 GB de RAM basta para un equipo pequeño. Kaneo es ligero: la API Hono (Node.js) y la SPA Vue.js consumen juntas menos de 200 MB en reposo; PostgreSQL 16 añade unos 300 MB. Docker y Docker Compose se aprovisionan automáticamente por AWX durante el despliegue. No es obligatorio un nombre de dominio — Kaneo funciona tras la URL asignada por ServOrbit — pero un subdominio dedicado (p. ej. projects.your-domain.com) facilita el acceso.

Kaneo admite múltiples espacios de trabajo en una misma instancia. Cada workspace tiene sus propios proyectos, miembros y webhooks — útil para separar clientes o equipos en un único VPS sin multiplicar los despliegues.

Para crear un segundo espacio de trabajo, haga clic en el selector en la parte superior izquierda de la interfaz y elija Nuevo espacio de trabajo. Los miembros de un workspace no tienen acceso a los demás: el aislamiento es a nivel de aplicación. Puede alojar los proyectos del cliente A y del cliente B en el mismo servidor, cada uno con sus tableros e integraciones de GitHub independientes.

Si necesita campos personalizados en las tareas, consulte la documentación oficial de Kaneo antes de depender de ellos: los custom fields forman parte de la hoja de ruta, pero su disponibilidad puede variar según la versión desplegada.

Los webhooks de Kaneo son una de sus ventajas más directas para los equipos de desarrollo. En cada cambio de estado de una tarea — movimiento de columna, asignación, comentario — Kaneo envía un POST JSON a la URL que elija.

Casos de uso habituales:

- Notificación de Slack: añada la URL de Incoming Webhook de su canal para recibir una alerta cuando una tarea pase a «En curso» o «Terminado».
- Disparo de pipeline CI: reenvíe el evento a su sistema de CI (GitHub Actions, Gitea Actions, Jenkins) para lanzar automáticamente una compilación o un despliegue cuando una tarea llegue a una columna objetivo.
- Sincronización con sistema externo: el endpoint puede apuntar a cualquier API REST — herramienta de reporting, base de tickets o un webhook de n8n para orquestar flujos complejos.

Pruebe sus endpoints con un servicio como webhook.site antes de conectarlos a producción, para verificar que el formato coincide con lo que espera su CI.

Kaneo almacena todos sus datos en PostgreSQL 16. Una copia de seguridad periódica es imprescindible: sin ella, una actualización fallida o una corrupción del volumen podría hacerle perder todo el historial de tareas.

Automatizar las copias de seguridad con cron y rclone

# /etc/cron.d/kaneo-backup
0 3 * * * root docker exec kaneo-db pg_dump -U kaneo kaneo | gzip > /var/backups/kaneo/$(date +\%Y\%m\%d).sql.gz
5 3 * * * root rclone copy /var/backups/kaneo/ s3:my-bucket/kaneo/ --max-age 30d

Reemplace kaneo-db por el nombre real de su contenedor PostgreSQL (docker ps para comprobarlo).

Restaurar una copia de seguridad

docker stop kaneo-app
gunzip -c /var/backups/kaneo/20260901.sql.gz | docker exec -i kaneo-db psql -U kaneo kaneo
docker start kaneo-app

Conserve al menos 7 dumps locales y 30 días de copias remotas. Pruebe una restauración en un entorno de prueba antes de necesitarla.

Kaneo publica sus versiones en GitHub. El procedimiento de actualización es estándar para un despliegue con Docker Compose:

docker compose pull
docker compose up -d
docker compose ps

Antes de cualquier actualización, realice una copia de seguridad completa. Lea las notas de la nueva versión en GitHub: algunas actualizaciones incluyen migraciones de base de datos que se aplican automáticamente al arrancar el contenedor. Si una migración falla, los logs del contenedor (docker logs kaneo-app) mostrarán los detalles.

Por defecto, Kaneo no requiere un servidor SMTP: el registro se hace con correo y contraseña, sin enlace de verificación. Esto simplifica el despliegue inicial pero limita las notificaciones por email (restablecimiento de contraseña, alertas de tareas).

Si su versión de Kaneo admite configuración SMTP, los parámetros se encuentran en las variables de entorno del docker-compose.yml desplegado:

SMTP_HOST=smtp.your-domain.com
SMTP_PORT=587
[email protected]
SMTP_PASSWORD=your-password
[email protected]

Tras modificar las variables, reinicie los contenedores con docker compose up -d. Pruebe el envío desde la interfaz de administración antes de cerrar el registro público.

El contenedor se reinicia continuamente en el primer arranque

Causa más frecuente: un secreto ausente o mal formateado en el archivo de entorno. Revise los logs del contenedor de la aplicación (docker logs kaneo-app).

La interfaz carga pero el inicio de sesión falla con «Invalid credentials»

La primera cuenta creada es la del administrador. Si reinició el contenedor sin eliminar el volumen de PostgreSQL, la cuenta ya existe en la base de datos: intente iniciar sesión con las credenciales introducidas en el primer registro.

Los webhooks no se disparan

Compruebe que la URL de destino es accesible desde el contenedor de Kaneo (no localhost en el VPS anfitrión — use una IP externa o un nombre de dominio).

La sincronización de GitHub se detiene tras unas horas

La GitHub App necesita que la URL de callback sea accesible por HTTPS desde Internet. Verifique que su certificado SSL es válido y que el puerto 443 está abierto en su VPS.

El rendimiento se degrada con muchas tareas

En un VPS con 1 GB de RAM, PostgreSQL puede convertirse en un cuello de botella cuando crece el volumen de datos. Aumente shared_buffers en la configuración de PostgreSQL o pase a un plan con 2 GB de RAM.