Base de Conhecimento

OpenProject na VPS: gestão de projetos da equipe

  • openproject, gestão de projetos, docker, vps, lgpd
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: OpenProject na VPS: gestão de projetos da equipe

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.

Esta resposta lhe foi útil?

Artigos Relacionados