Tutoriais de VPS
OpenProject na VPS: Docker, HTTPS, projetos e recuperação
Use release Compose coerente com PostgreSQL e cache privados. Configure projetos, permissões, e-mail, colaboração e backups consistentes; teste atualização e recuperação.

OpenProject reúne projetos, pacotes de trabalho, quadros, Gantt, horas, wiki e reuniões. Hospedar dá controle dos registros/acesso e exige manter atualizações, arquivos, e-mail e recuperação. Algumas funções dependem da edição e das integrações.
Usamos Ubuntu 24.04 e Compose oficial com PostgreSQL. Escolha template da mesma release: serviços, cache e variáveis mudam.
| Uso | CPU | RAM | Disco | Nota |
|---|---|---|---|---|
| Teste/demo | 2 vCPU | 4 GB | 50 GB SSD | Poucos usuários/tarefas |
| Equipe pequena | 4 vCPU | 8 GB | 100 GB NVMe | SMTP e backups independentes |
| Muitos projetos | 8 vCPU | 16 GB+ | 200 GB NVMe+ | Avaliar banco/arquivos/busca separados |
Configure A/AAAA de pm.example.com. Publique SSH/80/443 necessários, sem banco/cache/busca internos. Conte anexos, exportações, logs, WAL e backups na capacidade. Não garante número de usuários.
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
Revise instalador ou use pacotes suportados. Evite latest, registre imagens e guarde só templates sem segredos no Git. Proteja .env com chmod 600.
git clone https://github.com/opf/openproject-docker-compose.git compose
cd compose
cp .env.example .env
chmod 600 .env
Escolha branch/commit testado antes de copiar env. O template stable/17 revisado usa db, cache, proxy, web, worker, cron e seeder, com Memcached. Redis não é obrigatório nesse arranjo. Preserve seeder e persistência.
Esboço 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
Adapte: stable/17 usa SECRET_KEY_BASE, não OPENPROJECT_SECRET_KEY_BASE sem encaminhamento. POSTGRES_PASSWORD deve coincidir com DATABASE_URL; hostname é db, não postgres. O exemplo oficial conecta como administrador PostgreSQL: provisione papel limitado de aplicação/migração se necessário e altere URL/conta de backup de forma coerente.
Configure OPENPROJECT_HOST__NAME=pm.example.com, OPENPROJECT_HTTPS=true, PORT=127.0.0.1:8080, COLLABORATIVE_SERVER_SECRET independente e URL colaborativa externa compatível. Use volumes nomeados ou diretórios PGDATA/OPDATA dedicados, sem reutilizar dados alheios. Instância nova stable/17 usa PostgreSQL 17 documentado e patch/digest fixado; dados existentes exigem migração separada.
Preserve Memcached. .env só afeta o programa se Compose encaminha a variável: confira x-op-app. Use chaves estáveis coerentes em web/worker/cron/seeder.
docker compose config
docker compose pull
docker compose up -d
docker compose ps
Inspecione segredos em privado ou config --quiet só para sintaxe. Aguarde inicialização/seeder. No diagnóstico original, substitua 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
Em reinícios, confira URL, segredo, hostname e proprietário; preserve volumes.
Inicialize administração em privado e troque credenciais antes de convidar. Confirme HTTPS:
- Crie organização/equipe/projeto e responsáveis.
- Defina tarefas, bugs, marcos, riscos e mudanças.
- Ajuste estados e direitos de fechar/excluir/editar horas.
- Ative wiki, quadros, Gantt, horas e documentos compatíveis necessários.
- Salve template testado.
Clientes externos recebem papéis limitados e integrações credenciais próprias; membros comuns não precisam de administração 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
Publique proxy upstream só em 8080 privada. Para edição colaborativa, acrescente HTTP/1.1 e headers Upgrade/Connection no Nginx externo com map de connection-upgrade no contexto http. Sem isso, páginas podem funcionar e colaboração falhar. Confira /hocuspocus e URL wss externa de ponta a ponta.
Uma entrada ocupa 80/443; teste renovação. Caddy também atende. Em loops/CSRF/links HTTP, confira hostname, HTTPS e X-Forwarded-Proto do proxy confiável.
Configure SMTP, porta, usuário, senha e remetente; teste recebimento, spam e devoluções. SPF/DKIM/DMARC atendem domínio remetente; PTR pertence ao servidor que realmente envia, não necessariamente à VPS com provedor externo. Confira relógio, TLS e porta 587/465 ou outra documentada, sem presumir 25.
docker compose ps
docker compose logs --tail=200 worker
docker compose logs --tail=200 cron
Worker/cron processam notificações, arquivos, relatórios e limpeza. Para tarefas pendentes, confira OOM, locks e cache. Preserve erros antes de intervir; não esvazie filas.
Separe administradores de projeto, membros, relatores e leitores. Limite clientes/fornecedores/auditores, sem permissões globais desnecessárias.
- Usuário/token próprio por integração e projeto necessário.
- Tokens nos segredos CI, sem repositório/logs.
- Timeouts, retentativas e idempotência deliberados.
- Rotação e retirada de contas antigas.
Teste campos/estados/relações num projeto separado antes de importar lotes.
Anexos, gravações e exportações crescem. Use volume persistente e passe a objetos só com suporte documentado de versão/edição e teste mantendo originais.
- Meça CPU/RAM de web, worker e banco.
- Confira anexos, WAL e logs.
- Analise SQL lento e locks antes de ajustar banco.
- Mude cache/workers/busca depois de medir.
Mais workers podem causar OOM.
Guarde PostgreSQL, anexos, plugins, .env, Compose, chaves e digests. Esboço antigo:
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
Em stable/17 padrão, exporte com docker compose exec -T db pg_dump -U postgres openproject; adapte conta se mudou. Use pipefail, permissões privadas, timestamps únicos e gzip/hashes verificados. Pare escritas web/worker/cron para alinhar banco/arquivos. Inclua todos os env e nome Compose real.
Confira caminhos com docker compose ps e docker compose config privado. Criptografe .env/chaves e mantenha cópia externa. Restauração mensal deve isolar versão/projeto, desativar e-mail/integrações reais e testar login, projetos, pacotes, arquivos, API e relatórios.
- Registre aplicação, PostgreSQL, cache e plugins.
- Valide backups banco/arquivos/configuração e digests.
- Teste login, pacotes, quadros, Gantt, arquivos e e-mail.
- Pare escritas, baixe imagens alvo e aplique seeder/migração da versão nova.
- Confira tarefas/API antes de abrir acesso.
Sequência original de referência:
docker compose exec web bundle exec rake db:migrate
docker compose pull
docker compose up -d
docker compose logs --tail=200 web
Não migre com imagem antiga antes de baixar a nova. O template stable usa seeder: execute seu procedimento da imagem alvo durante manutenção e depois inicie web/worker/cron. Para voltar, use banco/arquivos anteriores compatíveis, sem conectar imagem antiga ao banco migrado.
Confira Nginx, 8080 privada, web/db, saúde e DNS. Ajuste proxy_read_timeout para relatórios medidos, investigando lentidão real.
Confira hostname, HTTPS, proxy e cookies/cache. Use URL pública coerente.
Verifique client_max_body_size, limites da aplicação, espaço e permissões. Isole teste local se integração de objetos falhar.
Confira SMTP, worker, cron, cache e banco. Reiniciar apenas web não recupera worker separado.
- Web/worker/cron/banco/cache funcionam e seeder/migrações terminaram.
- HTTPS, URL, headers e uploads testados.
- Papéis, tokens e MFA/integração de identidade suportada validados.
- SMTP, resets, avisos e tarefas passam testes reais.
- Banco/arquivos/configuração/plugins/imagens com backup externo.
- Recuperação isolada medida e testada.
- Versões fixadas e pacotes/quadros/Gantt/arquivos/API revisados após atualizar.
Comece com projeto template confiável e amplie conforme medições.
Leituras: