OpenProject en VPS: Gantt, hitos y seguimiento de tiempo

• Diagrama de Gantt interactivo con dependencias entre tareas y camino crítico
• Seguimiento de tiempo por tarea y por proyecto, exportable en CSV para la facturación
• Hitos y entregables contractuales vinculados a la hoja de ruta
• Wiki integrada para la documentación del proyecto, sin herramienta externa
• Gestión de versiones y releases para proyectos de software
• Control de acceso granular por rol (lector, contribuidor, jefe de proyecto, administrador)
• Licencia GPLv3: el código fuente es auditable y no se impone telemetría

OpenProject, Plane y Kaneo: tres herramientas, tres posicionamientos

Comparatif

Desplace la tabla

1. 01

   Preparar el VPS

   Conéctate por SSH, actualiza los paquetes e instala Docker con el plugin Compose: apt update && apt install -y docker.io docker-compose-plugin. Verifica con docker compose version (v2.x esperado).

2. 02

   Descargar el Compose oficial

   Clona el repositorio de despliegue oficial: git clone https://github.com/opf/openproject-deploy.git /opt/openproject && cd /opt/openproject/compose. Este repositorio mantiene el archivo docker-compose.yml y el archivo .env recomendados por el equipo de OpenProject.

3. 03

   Configurar las variables de entorno

   Copia el ejemplo: cp .env.example .env y edita .env. Variables obligatorias: OPENPROJECT_HOST__NAME=tu-dominio.com (doble guión bajo), OPENPROJECT_HTTPS=true, y SECRET_KEY_BASE generado con openssl rand -hex 64. Define también POSTGRES_PASSWORD y OPENPROJECT_DB_PASSWORD con el mismo valor fuerte.

4. 04

   Iniciar los contenedores

   Ejecuta docker compose up -d. La imagen openproject/community:latest descarga aproximadamente 600 MB. El primer arranque tarda de dos a cuatro minutos para que se ejecuten las migraciones de base de datos. Monitoriza con docker compose logs -f web hasta ver Listening on tcp://0.0.0.0:8080.

5. 05

   Verificar que la aplicación responde

   Desde el VPS: curl -s -o /dev/null -w "%{http_code}" http://localhost:8080. Un código 200 o 302 confirma que la aplicación está en línea. En este momento solo es accesible localmente — el proxy inverso nginx viene en el siguiente paso.

1. 06

   Instalar nginx y certbot

   En Debian/Ubuntu: apt install -y nginx certbot python3-certbot-nginx. Asegúrate de que el DNS del dominio apunta a la IP del VPS antes de continuar.

2. 07

   Crear el vhost de nginx

   Crea /etc/nginx/sites-available/openproject con: server { listen 80; server_name tu-dominio.com; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-Proto https; proxy_read_timeout 120s; client_max_body_size 100M; } }. Actívalo: ln -s /etc/nginx/sites-available/openproject /etc/nginx/sites-enabled/ && nginx -t && systemctl reload nginx.

3. 08

   Obtener el certificado TLS

   Ejecuta certbot --nginx -d tu-dominio.com. Certbot modifica el vhost para escuchar en el puerto 443, añade las directivas ssl_certificate y configura la redirección HTTP→HTTPS automáticamente. El certificado se renueva mediante el timer systemd certbot.timer.

Crear el primer proyecto y configurar el Gantt

1. 09

   Acceder a la interfaz y cambiar la contraseña de administrador

   Abre https://tu-dominio.com en un navegador. Inicia sesión con admin / admin y cambia la contraseña inmediatamente. Configura la URL de la aplicación en Administración > Configuración > General si no se detectó automáticamente desde OPENPROJECT_HOST__NAME.

2. 10

   Crear un proyecto e invitar miembros

   Haz clic en Nuevo proyecto, elige un nombre, activa los módulos útiles: Paquetes de trabajo, Gantt, Seguimiento de tiempo, Wiki. Invita a los miembros desde la pestaña Configuración > Miembros asignándoles un rol.

3. 11

   Crear tareas y definir dependencias

   En la vista de lista de paquetes de trabajo, crea las primeras tareas con fechas de inicio y fin. Cambia a la vista Gantt para visualizar la línea de tiempo. Para crear una dependencia, abre una tarea y rellena el campo Precedida por con el número de la tarea precedente.

4. 12

   Configurar hitos

   Un hito es una tarea de tipo Milestone. Créala desde la vista Gantt (tipo Milestone) o desde la lista cambiando el tipo. Los hitos aparecen como rombos en el diagrama — útiles para marcar entregables contractuales.

5. 13

   Activar las hojas de tiempo

   En Administración > Configuración > Registros de trabajo, activa el módulo. Cada miembro puede registrar su tiempo mediante el botón cronómetro en una tarea abierta. Los informes agregados por proyecto y período están disponibles en Informes > Registros de trabajo.

Solución de problemas — errores frecuentes

• 502 Bad Gateway en el primer arranque: las migraciones Rails no han terminado. Espera de dos a cinco minutos y comprueba docker compose logs web para confirmar que escucha en el puerto 8080.
• Página en blanco o error 500: SECRET_KEY_BASE está vacío o mal definido. Regénéralo con openssl rand -hex 64 y reinicia con docker compose up -d --force-recreate.
• Archivos adjuntos rechazados: el límite por defecto de nginx es 1 MB. Aumenta client_max_body_size en el vhost (100 MB recomendado para archivos de proyecto).
• Problemas de envío de correos: configura las variables OPENPROJECT_SMTP_* en .env (servidor SMTP, puerto 587, credenciales). Sin configuración SMTP, las invitaciones a miembros no se envían.
• Actualización de la imagen: docker compose pull && docker compose up -d. OpenProject ejecuta las migraciones automáticamente al arrancar. Haz una copia de seguridad de la base de datos antes de cada actualización mayor.