OpenProject na VPS: gestão de projetos da equipe
OpenProject 17.9.7: licença GPLv3, requisitos oficiais, instalação com Docker Compose, HTTPS com proxy, e-mail, correções de segurança, backup e atualização.
Por Redação Eleven Host · @robson.direitodigital · 13 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: OpenProject na VPS: gestão de projetos da equipe Arte: Eleven Host
OpenProject na VPS é um jeito de manter a gestão de projetos da equipe no seu próprio servidor, com tarefas, cronograma em Gantt e quadros Kanban. Veja os requisitos oficiais, a instalação com Docker Compose, o HTTPS, o e-mail, o backup e a atualização.
Atualizado em 13/11/2026. Na data de hoje, a versão estável mais nova é a 17.9.7, publicada em 09/11/2026. Os comandos e arquivos de exemplo abaixo não foram executados: confira cada um no seu servidor antes de usar.
O que é o OpenProject e qual é a licença
O OpenProject é um software de gestão de projetos pela web, de código aberto, para equipes e organizações. As tarefas aparecem na interface como work packages, ou pacotes de trabalho. Entre os recursos do projeto estão o planejamento com gráficos de Gantt, quadros Kanban e Scrum, wikis, fóruns, registro de horas e orçamento.
O OpenProject é código aberto sob a licença GPLv3, e a edição Community é gratuita. Na data de hoje, a versão estável é a 17.9.7, e os requisitos oficiais pedem 4 núcleos, 4096 MB de memória e 20 GB livres para até 200 usuários.
O projeto tem três edições: a Community, gratuita e de código aberto, a Enterprise on-premises, no servidor do cliente, e a Enterprise cloud, hospedada pelo fabricante. Recursos como login único por SAML e sincronização com LDAP são só da Enterprise, e os preços são do fabricante.
Para quem serve
São exemplos de uso, sem promessa de resultado: uma equipe que quer organizar tarefas e prazos num cronograma, ou uma empresa que prefere guardar o planejamento num servidor sob o seu controle. Para entender o que é uma VPS, o guia completo de servidor VPS explica o básico.
Requisitos oficiais
Para um servidor único com até 200 usuários, a página de requisitos pede 4 núcleos (>= 2 GHz), 4096 MB de memória e 20 GB de disco livres. Para cerca de 500 usuários, a faixa sobe para 8 núcleos, 8 GB de memória e 40 GB de disco. É um requisito alto para um servidor pequeno.
- Docker: a instalação por contêineres exige um sistema com Docker instalado;
- banco: o PostgreSQL 16 ou mais novo é o oficialmente suportado desde o OpenProject 16.0.0. O compose já traz um PostgreSQL próprio;
- pacotes DEB e RPM: o fabricante informa que não vai gerar pacote para versões novas de Linux, como o Ubuntu 24.04, e nesses casos indica migrar para o Docker Compose.
Por isso o passo a passo usa o Docker Compose, que a documentação recomenda para instâncias menores.
Antes de contratar, anote os requisitos oficiais do OpenProject e confira na loja o que cada plano de VPS inclui. Ver as VPS
Instalação com Docker Compose, na ordem
Primeiro, o servidor precisa ter o Docker com o plugin do Compose e o git, e o Docker deve ser instalado pelo método da documentação do próprio Docker. Segundo, baixe o repositório oficial do compose, no ramo stable/17, e entre na pasta:
git clone https://github.com/opf/openproject-docker-compose.git --depth=1 --branch=stable/17 openproject
cd openproject
Terceiro, copie o arquivo de exemplo para o .env, que você vai editar:
cp .env.example .env
Quarto, troque os segredos que vêm no arquivo de exemplo. O SECRET_KEY_BASE vem como OVERWRITE_ME, e o COLLABORATIVE_SERVER_SECRET vem como secret12345: os dois precisam ser trocados. A DATABASE_URL também traz a senha p4ssw0rd do banco. Recomendamos trocar essa senha também, e antes do primeiro início confira no docker-compose.yml se o serviço db usa a mesma senha, para mudar em todos os lugares onde ela aparece.
O SECRET_KEY_BASE deve ser único e tratado como senha, e trocá-lo depois invalida todas as sessões. Um exemplo de comando, que mostra o valor na tela, para colar depois do SECRET_KEY_BASE= no .env:
openssl rand -hex 64
Quinto, a versão. O .env.example vem com TAG=17-slim, uma tag flutuante da série 17: ela puxa as versões novas sozinha. A documentação recomenda tags fixas em produção. Recomendamos fixar a versão no TAG, por exemplo com a linha abaixo. Confira no Docker Hub o nome exato da tag antes de usar:
TAG=17.9.7-slim
Sexto, a pasta dos anexos, se mantiver o OPDATA padrão, com o dono que os contêineres usam:
sudo mkdir -p /var/openproject/assets
sudo chown 1000:1000 -R /var/openproject/assets
Sétimo, a porta. A página do compose diz que o padrão escuta em todas as interfaces, mas o .env.example do ramo stable/17 traz PORT=127.0.0.1:8080, só local. Confira a linha PORT no seu .env e mantenha esse valor: o acesso externo passa pelo proxy com HTTPS, mais abaixo.
Oitavo, o primeiro início, só para teste. O OPENPROJECT_HTTPS=false serve só para o primeiro acesso. O comando da documentação, aqui sem a variável SECRET_KEY_BASE porque a chave já está gravada no .env, é este:
OPENPROJECT_HTTPS=false docker compose up -d --build --pull always
Para acompanhar o início, um exemplo de comandos:
docker compose ps
docker compose logs -n 100
Um comando que apaga todos os dados
O comando docker volume rm compose_opdata compose_pgdata, citado na documentação, apaga tudo, sem volta. Não o rode sem uma cópia fora do servidor.
Primeiro acesso e senha do admin
Com a porta só local, http://localhost:8080 abre dentro do servidor, e não no seu computador. Um exemplo de túnel por SSH, com um IP de documentação:
ssh -L 8080:127.0.0.1:8080 usuario@203.0.113.10
Com o túnel aberto, acesse http://localhost:8080 no navegador do seu computador. O login padrão é admin e a senha é admin. Troque a senha do administrador logo no primeiro acesso, antes de ligar o domínio.
Domínio e HTTPS
A documentação recomenda usar o OpenProject atrás de um proxy que termine o TLS em produção, e com o HTTPS ligado e sem proxy o navegador mostra ERR_SSL_PROTOCOL_ERROR. O OPENPROJECT_HOST__NAME tem de ser o endereço que o usuário digita no navegador, para evitar o risco de HOST header injection.
Antes de tudo, o endereço, como projetos.exemplo.com, precisa apontar para o IP da VPS. Para domínios registrados conosco, há DNS gerenciado grátis na rede da Cloudflare, com painel na área do cliente.
O proxy Caddy do compose repassa os cabeçalhos X-Forwarded-* sem defini-los, e a documentação manda configurar o trusted_proxies no Caddyfile, na pasta proxy; confira o arquivo no seu servidor.
Para o certificado, uma opção é um Nginx no próprio servidor com o Let's Encrypt, como mostra o artigo Certbot na VPS: SSL grátis do Let's Encrypt no Nginx. A documentação diz que o OpenProject não termina o TLS sozinho. Um exemplo de bloco do Nginx, com a linha X-Forwarded-Proto https da documentação e o suporte a WebSocket para a edição colaborativa em /hocuspocus:
server {
server_name projetos.exemplo.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
Com o proxy respondendo em HTTPS, volte ao .env e ajuste os valores. Um exemplo, com um domínio fictício:
OPENPROJECT_HOST__NAME=projetos.exemplo.com
OPENPROJECT_HTTPS=true
PORT=127.0.0.1:8080
COLLABORATIVE_SERVER_URL=wss://projetos.exemplo.com/hocuspocus
Para ler os valores novos, rode o docker compose up -d de novo.
E-mail para as notificações
Sem o envio de e-mail configurado, os avisos por e-mail e os convites de usuários não saem. A configuração fica em Administração, Emails and notifications, no formulário SMTP. Também dá para usar variáveis de ambiente, como OPENPROJECT_SMTP__ADDRESS e OPENPROJECT_SMTP__PORT, e nesse caso a documentação avisa que as opções da tela de administração ficam desativadas.
Um problema comum é o contêiner sem DNS para alcançar o servidor SMTP externo.
Segurança: atualize para a 17.9.7 ou mais nova
Em 10/11/2026, o projeto publicou 12 avisos de segurança, e duas das falhas são críticas. As correções saíram na 17.9.7, publicada em 09/11/2026. Por isso recomendamos instalar a 17.9.7 ou mais nova e manter o sistema atualizado. O compose oficial também inclui o serviço autoheal, que monta o /var/run/docker.sock e, por isso, tem acesso ao Docker do servidor.
Backup e atualização
A documentação recomenda com firmeza fazer cópia antes de atualizar. As páginas oficiais de backup e atualização escrevem docker-compose, com hífen, que é a grafia da versão antiga do mesmo comando; os blocos abaixo usam docker compose. A receita de backup do compose usa o arquivo docker-compose.control.yml:
docker compose down
docker compose -f docker-compose.yml -f docker-compose.control.yml build
docker compose -f docker-compose.yml -f docker-compose.control.yml run backup
docker compose up -d
Uma cópia completa leva o banco, os arquivos de configuração e os anexos, que, no padrão do OPDATA, ficam em /var/openproject/assets. Recomendamos guardar também o .env, que contém o SECRET_KEY_BASE, e copiar tudo para fora da VPS. O artigo Backup da VPS: como fazer cópia automática mostra como fazer cópia automática na VPS.
Para atualizar, com a cópia pronta, a página do compose manda atualizar o repositório e subir de novo. Com a versão fixa, troque antes o TAG do .env para a versão nova. Um exemplo de comandos:
git pull origin stable/17
docker compose -f docker-compose.yml -f docker-compose.control.yml build
docker compose -f docker-compose.yml -f docker-compose.control.yml run upgrade
docker compose up -d --build --pull always
Numa troca de versão maior, a documentação manda passar por cada versão maior, sem pular da X para a X+2.
Dados da equipe e LGPD
Um sistema de projetos guarda nomes e e-mails das pessoas da equipe, e o registro de horas mostra o que cada uma fez. A LGPD, a lei brasileira de proteção de dados, trata esse tipo de informação, e um software não garante conformidade sozinho. Recomendamos limitar quem acessa o sistema, manter o HTTPS ligado, guardar a cópia fora do servidor e tratar o assunto com o jurídico da empresa.
Servidor e endereço da equipe
Um sistema que a equipe inteira usa pede o mesmo cuidado de dimensionamento de outros sistemas da empresa, e o artigo Servidor para ERP: como dimensionar o da sua empresa mostra como pensar essa conta.
Subdomínio como projetos.exemplo.com parte de um domínio registrado, e a Eleven Host registra domínios com centenas de extensões. Buscar domínio
Perguntas frequentes
O OpenProject é gratuito?
O código é aberto, sob a licença GPLv3, e a edição Community é gratuita. Recursos como login único por SAML e sincronização com LDAP são da Enterprise, e os preços são do fabricante.
Qual é a versão estável na data de hoje?
A 17.9.7, publicada em 09/11/2026. Ela traz as correções de segurança de novembro.
Posso deixar o HTTPS desligado?
Só no primeiro teste. A documentação aconselha com firmeza não deixar o OPENPROJECT_HTTPS em false em sistemas de produção.