Tutoriales de VPS
OpenProject en un VPS: Docker, HTTPS, proyectos y recuperación
Usa una release Compose coherente con PostgreSQL y caché privados. Configura proyectos, permisos, correo, colaboración y copias consistentes; ensaya actualización y recuperación.

OpenProject reúne proyectos, paquetes de trabajo, tableros, Gantt, tiempo, wiki y reuniones. Alojarlo da control de registros/acceso y exige mantener actualizaciones, archivos, correo y recuperación. Algunas funciones dependen de edición e integraciones.
Usamos Ubuntu 24.04 y Compose oficial con PostgreSQL. Elige plantilla de la misma release: servicios, caché y variables cambian.
| Uso | CPU | RAM | Disco | Nota |
|---|---|---|---|---|
| Prueba/demo | 2 vCPU | 4 GB | 50 GB SSD | Pocos usuarios/tareas |
| Equipo pequeño | 4 vCPU | 8 GB | 100 GB NVMe | SMTP y copias independientes |
| Muchos proyectos | 8 vCPU | 16 GB+ | 200 GB NVMe+ | Evaluar separación de base/archivos/búsqueda |
Configura A/AAAA para pm.example.com. Publica SSH/80/443 necesarios, sin base/caché/búsqueda internos. Cuenta adjuntos, exportaciones, logs, WAL y copias en capacidad. No garantiza cantidad de usuarios.
sudo apt update
sudo apt install -y ca-certificates curl git openssl
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker "$USER"
newgrp docker
sudo mkdir -p /opt/openproject
sudo chown -R "$USER":"$USER" /opt/openproject
cd /opt/openproject
Revisa instalador o usa paquetes soportados. Evita latest, registra imágenes y guarda solo plantillas sin secretos en Git. Protege .env con chmod 600.
git clone https://github.com/opf/openproject-docker-compose.git compose
cd compose
cp .env.example .env
chmod 600 .env
Selecciona rama/commit probado antes de copiar el env. La plantilla stable/17 revisada usa db, cache, proxy, web, worker, cron y seeder, con Memcached. Redis no es obligatorio aquí. Conserva seeder y persistencia.
Esquema original:
OPENPROJECT_HOST__NAME=pm.example.com
OPENPROJECT_HTTPS=true
OPENPROJECT_SECRET_KEY_BASE=replace-with-a-long-random-secret
DATABASE_URL=postgres://openproject:change-a-long-password@postgres/openproject
OPENPROJECT_RAILS__CACHE__STORE=memcache
openssl rand -hex 64
openssl rand -base64 48
Adáptalo: stable/17 usa SECRET_KEY_BASE, no OPENPROJECT_SECRET_KEY_BASE sin reenviar. POSTGRES_PASSWORD debe coincidir con DATABASE_URL; hostname de la base es db, no postgres. El ejemplo oficial conecta con administrador PostgreSQL: provisiona un rol de aplicación/migración limitado si corresponde y cambia URL/cuenta de backup coherentemente.
Configura OPENPROJECT_HOST__NAME=pm.example.com, OPENPROJECT_HTTPS=true, PORT=127.0.0.1:8080, COLLABORATIVE_SERVER_SECRET distinto y URL colaborativa externa compatible. Usa volúmenes nombrados o directorios PGDATA/OPDATA dedicados, sin reutilizar datos ajenos. Instancia nueva stable/17 usa PostgreSQL 17 documentado y parche/digest fijado; datos existentes requieren migración aparte.
Conserva Memcached. .env solo afecta al programa si Compose reenvía la variable: revisa x-op-app. Usa claves estables coherentes en web/worker/cron/seeder.
docker compose config
docker compose pull
docker compose up -d
docker compose ps
Inspecciona secretos en privado o config --quiet solo para sintaxis. Espera inicialización/seeder. En diagnóstico original, reemplaza postgres por db:
docker compose logs --tail=200 web
docker compose logs --tail=200 worker
docker compose logs --tail=200 cron
docker compose logs --tail=200 postgres
En reinicios, revisa URL, secreto, hostname y propietario; conserva volúmenes.
Inicializa administración en privado y cambia credenciales antes de invitar. Confirma HTTPS:
- Crea estructura organización/equipo/proyecto y responsables.
- Define tareas, errores, hitos, riesgos y cambios.
- Ajusta estados y derechos para cerrar/borrar/editar horas.
- Activa wiki, tableros, Gantt, tiempo y documentos compatibles necesarios.
- Guarda una plantilla probada.
Clientes externos tienen roles limitados e integraciones credenciales propias; miembros normales no necesitan administración global.
sudo apt install -y nginx certbot python3-certbot-nginx
sudo nano /etc/nginx/sites-available/openproject
server {
listen 80;
server_name pm.example.com;
client_max_body_size 100m;
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-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 300s;
}
}
sudo ln -s /etc/nginx/sites-available/openproject /etc/nginx/sites-enabled/openproject
sudo nginx -t
sudo systemctl reload nginx
sudo certbot --nginx -d pm.example.com
Publica el proxy upstream solo en 8080 privado. Para edición colaborativa, añade HTTP/1.1 y headers Upgrade/Connection en Nginx externo mediante un map de connection-upgrade en contexto http. Sin ello, páginas pueden funcionar y colaboración fallar. Verifica /hocuspocus y URL wss externa de extremo a extremo.
Una entrada ocupa 80/443; prueba renovación. Caddy también sirve. En loops/CSRF/enlaces HTTP, revisa hostname, HTTPS y X-Forwarded-Proto del proxy confiable.
Configura SMTP, puerto, usuario, contraseña y remitente; prueba recepción, spam y rebotes. SPF/DKIM/DMARC corresponden al dominio remitente; PTR al servidor que realmente envía, no necesariamente al VPS con proveedor externo. Revisa reloj, TLS y puerto de envío 587/465 u otro documentado, sin asumir 25.
docker compose ps
docker compose logs --tail=200 worker
docker compose logs --tail=200 cron
Worker/cron procesan notificaciones, archivos, reportes y limpieza. Para pendientes, revisa OOM, locks y caché. Guarda errores antes de intervenir; no vacíes colas.
Separa administradores de proyecto, miembros, informadores y lectores. Limita clientes/proveedores/auditores, sin permisos globales innecesarios.
- Usuario/token propio por integración y proyecto requerido.
- Tokens en secretos CI, sin repositorio/logs.
- Timeouts, reintentos e idempotencia deliberados.
- Rotación y retirada de cuentas antiguas.
Prueba campos/estados/relaciones en proyecto de prueba antes de importar lotes.
Adjuntos, grabaciones y exportaciones crecen. Usa volumen persistente y pasa a objetos solo con soporte documentado de versión/edición y prueba con originales retenidos.
- Mide CPU/RAM de web, worker y base.
- Revisa adjuntos, WAL y logs.
- Analiza SQL lento y locks antes de ajustar base.
- Cambia caché/workers/búsqueda después de medir.
Más workers pueden causar OOM.
Guarda PostgreSQL, adjuntos, plugins, .env, Compose, claves y digests. Esquema antiguo:
mkdir -p /opt/openproject/backups
docker compose exec -T postgres pg_dump -U openproject openproject | gzip > /opt/openproject/backups/openproject-$(date +%F).sql.gz
docker compose cp web:/var/openproject/assets /opt/openproject/backups/assets-$(date +%F)
cp .env docker-compose.yml /opt/openproject/backups/
docker compose config > /opt/openproject/backups/compose-$(date +%F).yaml
En stable/17 por defecto, exporta con docker compose exec -T db pg_dump -U postgres openproject; adapta cuenta si cambió. Usa pipefail, permisos privados, timestamps únicos y gzip/hashes verificados. Detén escrituras web/worker/cron para alinear base/archivos. Incluye todos los env y nombre Compose real.
Comprueba rutas con docker compose ps y docker compose config privado. Cifra .env/claves y conserva copia externa. Restauración mensual debe aislar versión/proyecto, desactivar correo/integraciones reales y probar login, proyectos, paquetes, archivos, API y reportes.
- Registra aplicación, PostgreSQL, caché y plugins.
- Valida copias base/archivos/configuración y digests.
- Prueba login, paquetes, tableros, Gantt, archivos y correo.
- Detén escrituras, descarga imágenes objetivo y aplica seeder/migración de la versión nueva.
- Verifica tareas/API antes de abrir acceso.
Secuencia original de referencia:
docker compose exec web bundle exec rake db:migrate
docker compose pull
docker compose up -d
docker compose logs --tail=200 web
No migres con imagen antigua antes de descargar la nueva. La plantilla stable usa seeder: ejecuta su procedimiento de la imagen objetivo durante mantenimiento y después inicia web/worker/cron. Para volver, usa base/archivos previos compatibles, sin conectar imagen antigua a base migrada.
Revisa Nginx, 8080 privado, web/db, salud y DNS. Ajusta proxy_read_timeout para reportes medidos, investigando lentitud real.
Comprueba hostname, HTTPS, proxy y cookies/caché. Usa URL pública coherente.
Revisa client_max_body_size, límites de aplicación, espacio y permisos. Aísla prueba local si falla integración de objetos.
Revisa SMTP, worker, cron, caché y base. Reiniciar solo web no recupera un worker aparte.
- Web/worker/cron/base/caché funcionan y seeder/migraciones finalizaron.
- HTTPS, URL, headers y uploads probados.
- Roles, tokens y MFA/integración de identidad soportada verificados.
- SMTP, resets, avisos y tareas pasan pruebas reales.
- Base/archivos/configuración/plugins/imágenes con copia externa.
- Recuperación aislada medida y probada.
- Versiones fijadas y paquetes/tableros/Gantt/archivos/API revisados tras actualizar.
Empieza con proyecto plantilla fiable y amplía según mediciones.
Lecturas: