Instalação · 8 min read · Oct 31, 2025

Como Instalar o OpenProject no Ubuntu 22.04

OpenProject é um sistema de gerenciamento de projetos de código aberto e baseado na web. Ele fornece uma maneira segura e confiável para as equipes se conectarem, estruturarem seu trabalho e alcançarem resultados. Com o OpenProject, você pode organizar suas próprias tarefas e atribuir tarefas a um colega de equipe em um só lugar. Sua edição Community cobre uma ampla gama de recursos e plugins e é gratuita. Oferece uma ampla gama de funcionalidades, como planejamento e programação de projetos, Wikis, Fóruns, Agile e Scrum, rastreamento de bugs e muito mais.

Este post explicará como instalar o OpenProject com Docker no Ubuntu 22.04.

Pré-requisitos

  • Um servidor rodando Ubuntu 22.04.
  • Uma senha de root configurada no servidor.

Começando

Primeiro, você precisará atualizar e fazer upgrade dos pacotes do seu sistema para a versão mais recente. Você pode fazer isso com o seguinte comando:

apt update -y  
apt upgrade -y

Uma vez que todos os pacotes estejam atualizados, você pode prosseguir para o próximo passo.

Instalar o Docker

Em seguida, você precisará instalar o mecanismo Docker no seu servidor. Você pode instalá-lo executando o seguinte comando:

apt install docker.io -y

Uma vez que o Docker esteja instalado, você pode verificar a versão do Docker usando o seguinte comando:

docker --version

Você deve obter a versão do Docker na seguinte saída:

Docker version 20.10.12, build 20.10.12-0ubuntu4

Você também pode verificar o status do Docker com o seguinte comando:

systemctl status docker

Você receberá a seguinte saída:

? docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2022-09-12 03:55:27 UTC; 27min ago
TriggeredBy: ? docker.socket
       Docs: https://docs.docker.com
   Main PID: 2188 (dockerd)
      Tasks: 18
     Memory: 175.3M
        CPU: 2min 52.389s
     CGroup: /system.slice/docker.service
             ??2188 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

Sep 12 04:05:02 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:02.260137217Z" level=info msg="Container failed to exit within 10s of signal>
Sep 12 04:05:02 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:02.288143240Z" level=info msg="ignoring event" container=c69a4c77c21fcc30bf5>
Sep 12 04:05:02 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:02.313368392Z" level=info msg="ignoring event" container=1e168552ee6decb4d38>
Sep 12 04:05:02 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:02.346672185Z" level=info msg="ignoring event" container=4f042da15c0abe50ac0>
Sep 12 04:05:03 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:03.128611054Z" level=info msg="ignoring event" container=d07c7ddcf4c5c8e1df3>
Sep 12 04:05:03 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:03.471773239Z" level=info msg="ignoring event" container=f0095298f0394b4e97c>
Sep 12 04:05:03 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:03.860303969Z" level=info msg="ignoring event" container=7c591187d6dea45ad9c>
Sep 12 04:10:05 ubuntu2204 dockerd[2188]: time="2022-09-12T04:10:05.733958315Z" level=info msg="ignoring event" container=a9126dced469461963a>
Sep 12 04:17:00 ubuntu2204 dockerd[2188]: time="2022-09-12T04:17:00.365019409Z" level=info msg="ignoring event" container=317a71b1e5e2810e618>
Sep 12 04:19:40 ubuntu2204 dockerd[2188]: time="2022-09-12T04:19:40.133136639Z" level=info msg="ignoring event" container=e5fa71f4c2a7d8f3dc4>

Baixar e Iniciar o Container OpenProject

A maneira mais simples e fácil de instalar o OpenProject é lançá-lo com um container Docker. Você pode baixá-lo e executá-lo executando o seguinte comando:

docker run -dit -p 8080:80 -e OPENPROJECT_SECRET_KEY_BASE=secret -e OPENPROJECT_HOST__NAME=127.0.0.1:8080 -e OPENPROJECT_HTTPS=false openproject/community:12

Isso fará o download da imagem Docker da comunidade OpenProject e iniciará como mostrado abaixo:

Unable to find image 'openproject/community:12' locally
12: Pulling from openproject/community
76dff75df4d9: Pull complete 
3e8c90a1c4bb: Pull complete 
b3662c105080: Pull complete 
ad5dcb7dd592: Pull complete 
fa57cc7ce341: Pull complete 
9b3a1f58f992: Pull complete 
3ba44da7772d: Pull complete 
bb99cfe1d593: Pull complete 
d9be85920c31: Pull complete 
887163836f1b: Pull complete 
8d9b5634408e: Pull complete 
40cd37c7c054: Pull complete 
8f3f7ae1eab6: Pull complete 
0bad647edadc: Pull complete 
7604d9da2c69: Pull complete 
5064bcba96f5: Pull complete 
a31fefd0310b: Pull complete 
57856090623a: Pull complete 
c5788f49d4cb: Pull complete 
Digest: sha256:5b3850c813b44e0e83b31ee3ee7e65a22a05009f5101132caee51b4c799adaa9
Status: Downloaded newer image for openproject/community:12
cecc63dbe7c8263cdf9813a5dee5d5cfda3e2f8b8cdb78b3d038679507fa7769

Você pode verificar a imagem Docker baixada com o seguinte comando:

docker images

Você receberá a seguinte saída:

REPOSITORY              TAG       IMAGE ID       CREATED       SIZE
openproject/community   12        88f613862e98   11 days ago   1.93GB

Para verificar o status do container OpenProject, execute o seguinte comando:

docker ps

Você deve ver que o container OpenProject está iniciado e escutando na porta 8080:

CONTAINER ID   IMAGE                      COMMAND                  CREATED          STATUS          PORTS                                             NAMES
cecc63dbe7c8   openproject/community:12   "./docker/prod/entry…"   12 seconds ago   Up 11 seconds   5432/tcp, 0.0.0.0:8080->80/tcp, :::8080->80/tcp   silly_fermi

Você também pode verificar os logs do container OpenProject usando o seguinte comando:

docker logs cecc63dbe7c8

Você receberá a seguinte saída:

=> Booting Puma
=> Rails 7.0.3.1 application starting in production 
=> Run `bin/rails server --help` for more startup options
I, [2022-09-12T04:25:12.466164 #138]  INFO -- : Using schema cache file /app/db/schema_cache.yml
[138] Puma starting in cluster mode...
[138] * Puma version: 5.6.4 (ruby 3.1.2-p20) ("Birdie's Version")
[138] *  Min threads: 4
[138] *  Max threads: 16
[138] *  Environment: production
[138] *   Master PID: 138
[138] *      Workers: 2
[138] *     Restarts: (?) hot (?) phased
[138] * Preloading application
[138] * Listening on http://0.0.0.0:8080
[138] Use Ctrl-C to stop
[138] - Worker 1 (PID: 337) booted in 0.01s, phase: 0
[138] - Worker 0 (PID: 336) booted in 0.02s, phase: 0

Configurar o Apache como um Proxy Reverso para o OpenProject

Como você pode ver, o OpenProject escuta na porta 8080. Portanto, é recomendável configurar o Apache como um proxy reverso para acessar o OpenProject via porta 80.

Primeiro, instale o pacote do servidor web Apache usando o seguinte comando:

apt install apache2 -y

Uma vez que o Apache esteja instalado, ative os módulos necessários com o seguinte comando:

a2enmod proxy_http headers rewrite

Em seguida, crie um arquivo de configuração de host virtual do Apache com o seguinte comando:

nano /etc/apache2/sites-available/openproject.conf

Adicione as seguintes configurações:


ServerName openproject.linuxbuz.com

RewriteEngine on
RewriteRule "^$" "/" [R,L]

ProxyRequests off


ProxyPreserveHost On
ProxyPass http://127.0.0.1:8080/
ProxyPassReverse http://127.0.0.1:8080/

Salve e feche o arquivo, então ative o host virtual OpenProject com o seguinte comando:

a2ensite openproject.conf

Finalmente, reinicie o serviço Apache para aplicar as alterações:

systemctl reload apache2

Você também pode verificar o status do Apache com o seguinte comando:

systemctl status apache2

Você receberá a seguinte saída:

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2022-09-12 04:26:23 UTC; 1min 30s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 14508 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS)
   Main PID: 14058 (apache2)
      Tasks: 55 (limit: 4579)
     Memory: 5.4M
        CPU: 98ms
     CGroup: /system.slice/apache2.service
             ??14058 /usr/sbin/apache2 -k start
             ??14512 /usr/sbin/apache2 -k start
             ??14513 /usr/sbin/apache2 -k start

Sep 12 04:26:23 ubuntu2204 systemd[1]: Starting The Apache HTTP Server...

Proteger o OpenProject com SSL do Let’s Encrypt

Também é recomendável habilitar SSL no site do OpenProject. Primeiro, instale o pacote do cliente Certbot com o seguinte comando:

apt install python3-certbot-apache -y

Em seguida, execute o seguinte comando para baixar e instalar o SSL do Let’s Encrypt para o domínio do seu site.

certbot --apache -d openproject.linuxbuz.com

Responda a todas as perguntas como mostrado abaixo para instalar o SSL do Let’s Encrypt:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Enter email address (used for urgent renewal and security notices)
 (Enter 'c' to cancel): [email protected]


- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017-w-v1.3-notice.pdf.
You must agree in order to register with the ACME server. Do you agree?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: (Y)es/(N)o: Y

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing, once your first certificate is successfully issued, to
share your email address with the Electronic Frontier Foundation, a founding
partner of the Let's Encrypt project and the non-profit organization that
develops Certbot? We'd like to send you email about our work encrypting the web,
EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Account registered.
Requesting a certificate for openproject.linuxbuz.com

Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/openproject.linuxbuz.com/fullchain.pem
Key is saved at:         /etc/letsencrypt/live/openproject.linuxbuz.com/privkey.pem
This certificate expires on 2022-12-11.
These files will be updated when the certificate renews.
Certbot has set up a scheduled task to automatically renew this certificate in the background.

Deploying certificate
Successfully deployed certificate for openproject.linuxbuz.com to /etc/apache2/sites-available/openproject-le-ssl.conf
Added an HTTP->HTTPS rewrite in addition to other RewriteRules; you may wish to check for overall consistency.
Congratulations! You have successfully enabled HTTPS on https://openproject.linuxbuz.com
We were unable to subscribe you the EFF mailing list because your e-mail address appears to be invalid. You can try again later by visiting https://act.eff.org.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
If you like Certbot, please consider supporting our work by:
 * Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
 * Donating to EFF:                    https://eff.org/donate-le
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Acessar a Interface Web do OpenProject

Agora, abra seu navegador e acesse o OpenProject usando a URL https://openproject.linuxbuz.com. Você deve ver a página de boas-vindas do OpenProject:

Clique no botão Entrar. Você deve ver a página de login do OpenProject:

Forneça o nome de usuário e a senha padrão como admin / admin, em seguida, clique no botão Entrar. Você deve ver a tela de alteração de senha:

Altere sua senha padrão e clique no botão Salvar. Você deve ver o painel do OpenProject na tela seguinte:

Conclusão

Parabéns! você instalou com sucesso o OpenProject com Docker no Ubuntu 22.04. Agora você pode implementar o OpenProject em sua organização e começar a gerenciar e rastrear seu projeto a partir de um local central.

Share: X/Twitter LinkedIn
#Instalação

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.