Base de Conhecimento

Redmine na VPS: gestão de projetos no seu servidor

  • redmine, docker compose, gestão de projetos, nginx, mysql, vps
  • Usuários acharam útil: 0

Monte o Redmine no seu servidor com Docker Compose: versões, imagem mantida pela comunidade Docker, MySQL 8.4, HTTPS, backup de banco e anexos e atualização.

Por Redação Eleven Host · @robson.direitodigital · 6 de novembro de 2026 · 11 min de leitura

Arte da Eleven Host: janela de terminal com o título: Redmine na VPS: gestão de projetos no seu servidor

Capa da Redação Eleven Host para o guia: Redmine na VPS: gestão de projetos no seu servidor Arte: Eleven Host

Redmine na VPS é o caminho para ter a gestão de projetos da sua equipe no seu próprio servidor, com Docker Compose, MySQL, Nginx e HTTPS. Veja versões, backup, atualização e os cuidados com a porta.

Atualizado em 06/11/2026. Os números de versão deste guia são um retrato do dia e mudam; confira a página de downloads do Redmine antes de começar. Os blocos de comando e de configuração são exemplos montados para este guia: confira cada um no seu servidor antes de usar.

O que é o Redmine

A página oficial descreve o Redmine como uma aplicação web flexível de gestão de projetos que você mesmo pode hospedar. Ela é de código aberto, sob a licença GPL v2. A licença é só um dos pontos: o servidor, o domínio, o e-mail de saída e a manutenção continuam sendo custos seus.

Entre os recursos listados na página, estão vários projetos, papéis, chamados, Gantt e calendário, wiki e fórum por projeto e controle de horas. Se você ainda está escolhendo o servidor, o guia completo de servidor VPS explica o que é uma VPS. Se precisa só de uma wiki da empresa, o guia de BookStack na VPS é outra opção, e para um sistema de chamados de TI há o guia de GLPI na VPS.

A imagem do Redmine no Docker Hub é a imagem oficial do Docker, mantida pela comunidade Docker, e não uma imagem do projeto Redmine. O suporte dela é da comunidade Docker.

Versões na data deste guia

A página de downloads lista a 7.0.3 como a versão estável mais recente, com recursos novos, correções de bugs e atualizações de segurança. A 6.1.6 recebe só correções de bugs e de segurança, e a 6.0.12 é a versão legada, que recebe apenas atualizações importantes de segurança. A série 5.1, a 5.0, a 4 e as anteriores aparecem como sem suporte.

A página de alertas de segurança do projeto lista, entre os problemas corrigidos nas versões 7.0.3 e 6.1.6, falhas de escopo de token OAuth, XSS refletido em anexos e um ReDoS em macro de wiki. Por isso, recomendamos partir da versão estável mais recente e acompanhar os alertas.

Ruby e banco de dados

A tabela do guia de instalação do Redmine diz que a série 7.0 usa o Rails 8.1 e aceita Ruby da 3.2 à 4.0, com PostgreSQL 14, MySQL da 8.0 à 8.4, SQL Server 2012 ou mais novo e SQLite 3. A orientação é rodar o Redmine 7.0 no Ruby 4.0.4 ou mais novo, e a imagem do Docker usa o Ruby 4.0. O guia avisa que o MySQL precisa ter o transaction_isolation em READ COMMITTED para funcionar direito, e que o SQLite não serve para produção com vários usuários.

Dois prazos pesam na escolha. O MySQL 8.0 entrou em suporte de sustentação da Oracle em 21/04/2026, e a Oracle incentiva migrar para o 8.4 ou o 9.7, ambos LTS. O PostgreSQL 14, a única versão da tabela do Redmine, tem a última versão publicada em 12/11/2026, seis dias depois da data deste guia; a tabela não diz se versões mais novas servem, e isso pede teste seu. Por isso, o exemplo deste guia usa o MySQL 8.4.

Docker e a imagem do Redmine

A imagem redmine do Docker Hub tem como mantenedor a comunidade Docker, e o README do repositório dela avisa para não confundi-la com uma imagem oficial do projeto Redmine. O guia de instalação do próprio Redmine descreve a instalação com Ruby e Bundler, sem Docker.

Para instalar o Docker, a documentação aceita o Ubuntu 22.04, 24.04 e 26.04 LTS, entre outros, e traz o repositório apt oficial. Depois de adicionar o repositório, os comandos finais são os abaixo, e o hello-world confere a instalação. A documentação do Docker desaconselha o script de conveniência em produção. Um exemplo, para conferir no seu servidor:

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo docker run hello-world

Para ver outro serviço montado com Docker em uma VPS, o guia de Gitea na VPS mostra um servidor Git próprio com Docker.

Servidor virtual é uma das opções na sua lista? Confira na loja o que cada plano inclui. Ver as VPS

Por que o Compose do Docker Hub não vai direto ao servidor

O repositório da imagem traz um compose.yaml de exemplo com a porta 8080:3000, senhas de exemplo no arquivo, imagem sem versão fixa, nenhum volume nomeado, o usuário root no banco, o MySQL 8.0 e o REDMINE_SECRET_KEY_BASE, variável que o Docker Hub marca como obsoleta, e sem READ-COMMITTED. Para um servidor público, ele serve só como ponto de partida.

Um detalhe de segurança vem da documentação do Docker: as portas de contêiner publicadas passam por cima das regras do firewall. Com a porta publicada só em 127.0.0.1, apenas o próprio servidor a acessa, segundo a documentação do Docker; em versões anteriores à 28.0.0, máquinas do mesmo segmento de rede podiam alcançá-la, então mantenha o Docker atualizado. Não conte com o ufw para proteger uma porta publicada pelo Docker.

Um exemplo de compose.yaml para servidor, com versão fixa, banco MySQL 8.4 e volumes. Confira no seu servidor antes de usar. Ao copiar, confira também a indentação, porque o YAML depende dela: cada nível tem 2 espaços. Antes de subir, crie ao lado dele o arquivo configuration.yml já com o bloco de e-mail da seção adiante; não deixe esse arquivo vazio, porque o Redmine recusa um arquivo de configuração sem conteúdo válido, nem ausente, porque o Docker pode criar uma pasta no lugar:

services:

redmine:

image: redmine:7.0.3

restart: always

depends_on:

db:

condition: service_healthy

ports:

- "127.0.0.1:8080:3000"

environment:

REDMINE_DB_MYSQL: db

REDMINE_DB_USERNAME: redmine

REDMINE_DB_PASSWORD: ${DB_PASSWORD}

REDMINE_DB_DATABASE: redmine

SECRET_KEY_BASE: ${SECRET_KEY_BASE}

volumes:

- redmine_files:/usr/src/redmine/files

- ./configuration.yml:/usr/src/redmine/config/configuration.yml

db:

image: mysql:8.4

restart: always

command: --transaction-isolation=READ-COMMITTED --character-set-server=utf8mb4

environment:

MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}

MYSQL_DATABASE: redmine

MYSQL_USER: redmine

MYSQL_PASSWORD: ${DB_PASSWORD}

volumes:

- mysql_data:/var/lib/mysql

healthcheck:

test: ["CMD-SHELL", "mysqladmin ping -h 127.0.0.1 -uroot -p$$MYSQL_ROOT_PASSWORD --silent"]

interval: 10s

timeout: 5s

retries: 10

volumes:

redmine_files:

mysql_data:

As senhas e o segredo ficam num arquivo .env ao lado do compose, com as variáveis DB_PASSWORD, DB_ROOT_PASSWORD e SECRET_KEY_BASE. Um exemplo para gerar um valor e restringir o arquivo:

openssl rand -hex 32

chmod 600 .env

Trocar a SECRET_KEY_BASE invalida as sessões abertas depois do reinício. Para subir, use docker compose up -d e acompanhe com docker compose logs -f redmine. Se o seu usuário não estiver no grupo do Docker, ponha sudo antes dos comandos docker.

Primeiro acesso

O Docker Hub informa que o usuário e a senha padrão do projeto são admin e admin. Como a porta do exemplo só escuta em 127.0.0.1, o navegador chega ao Redmine depois do Nginx e do HTTPS, na próxima seção: faça esse primeiro login logo em seguida e troque a senha na hora, antes de passar o endereço para a equipe. A senha nova precisa ter pelo menos 8 caracteres, segundo o guia de contas.

O guia de instalação do projeto cita o comando redmine:load_default_data para carregar os dados padrão, e o script de entrada da imagem não o executa sozinho. A variável REDMINE_LANG evita a pergunta do idioma. Um exemplo de comando, para conferir no seu servidor:

docker compose exec -u redmine -e REDMINE_LANG=pt-BR redmine rake redmine:load_default_data

Os anexos ficam no diretório files/ do Redmine, que na imagem é /usr/src/redmine/files, e por isso o exemplo usa o volume redmine_files.

Nginx, HTTPS e e-mail

O guia de instalação do Redmine não cobre Docker com Nginx, e o tutorial do wiki do projeto para Nginx é antigo. Dele aproveitamos só a ideia do cabeçalho X-Forwarded-Proto e do client_max_body_size. Um exemplo de bloco, com domínio fictício, antes de rodar o Certbot:

server {

listen 80;

server_name redmine.exemplo.com.br;

client_max_body_size 10m;

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;

}

}

O Certbot da EFF, na página para Nginx em Linux por snap, usa estes comandos:

sudo snap install --classic certbot

sudo ln -s /snap/bin/certbot /usr/local/bin/certbot

sudo certbot --nginx

sudo certbot renew --dry-run

Depois, em Administração, Configurações, ajuste o nome do host e o caminho e o protocolo usado nos links dos e-mails. O padrão dessa opção é http.

Para o e-mail de saída, o configuration.yml.example do projeto mostra o bloco email_delivery. Um exemplo com SMTP genérico e valores fictícios:

production:

email_delivery:

delivery_method: :smtp

smtp_settings:

enable_starttls_auto: true

address: "smtp.exemplo.com.br"

port: 587

domain: "exemplo.com.br"

authentication: :plain

user_name: "redmine@exemplo.com.br"

password: "<senha>"

As páginas de e-mail do projeto mostram o bloco em formatos diferentes, então confira o resultado enviando uma mensagem de teste. Depois de salvar o arquivo, rode docker compose restart redmine.

Backup e restauração

A página de backup do Redmine trata de duas partes: o banco de dados e os arquivos enviados. Faça as duas. Um exemplo de backup e de restauração, adaptado ao compose acima, para conferir no seu servidor antes de contar com ele:

docker compose exec -T db sh -c 'exec mysqldump --single-transaction -uroot -p"$MYSQL_ROOT_PASSWORD" redmine' > redmine-$(date +%F).sql

docker run --rm --volumes-from "$(docker compose ps -q redmine)" -v "$(pwd)":/backup ubuntu tar czf /backup/files-$(date +%F).tar.gz -C /usr/src/redmine files

Para restaurar, o caminho inverso, trocando AAAA-MM-DD pela data do backup:

docker compose exec -T db sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD" redmine' < redmine-AAAA-MM-DD.sql

docker run --rm --volumes-from "$(docker compose ps -q redmine)" -v "$(pwd)":/backup ubuntu tar xzf /backup/files-AAAA-MM-DD.tar.gz -C /usr/src/redmine

Guarde também a configuração

Guarde junto o .env, o compose.yaml e o configuration.yml, e mantenha cópias fora do servidor. Se você usar a chave database_cipher_key no configuration.yml, o exemplo do projeto avisa que perder ou trocar essa chave deixa os dados criptografados ilegíveis. O agendamento do backup, por exemplo com cron, é escolha sua, e teste a restauração em outro lugar.

Atualizar de versão

O guia de atualização do Redmine recomenda fazer backup do banco e dos arquivos enviados antes de atualizar. Fora do Docker, o procedimento roda a migração do banco e a dos plugins à mão. Na imagem, o script de entrada migra o banco sozinho quando o contêiner inicia, a menos que a variável REDMINE_NO_DB_MIGRATE esteja definida. Isso é um risco a conhecer: trocar a tag e subir o contêiner já altera o banco, e voltar a tag antiga não desfaz a migração. Para desfazer, restaure o backup.

Um exemplo de roteiro: faça o backup, troque a tag no compose.yaml e rode:

docker compose pull

docker compose up -d

docker compose logs -f redmine

Plugins e temas pedem atenção à parte: a 7.0 moveu o CSS icon-* e removeu a gem html-pipeline.

Depois que o servidor está no ar

Com o Redmine funcionando, o trabalho passa a ser acompanhar os alertas de segurança e manter as cópias em dia.

Dá para ver com calma os planos de VPS da Eleven Host? Confira na loja o que cada plano inclui. Ver os planos

Perguntas frequentes

A imagem do Redmine no Docker é do projeto Redmine?

Não. Ela é a imagem oficial do Docker, mantida pela comunidade Docker, e o repositório dela avisa para não confundi-la com uma imagem do projeto. O suporte é da comunidade Docker.

Posso copiar o compose.yaml do Docker Hub?

Em um servidor público, não recomendamos. Ele traz senhas de exemplo, porta publicada sem restrição de endereço e versões sem fixar. Use o exemplo deste guia como base e confira cada item.

O ufw protege a porta publicada pelo Docker?

Não conte com isso. A documentação do Docker diz que as portas publicadas passam por cima das regras do firewall. Publique em 127.0.0.1 e deixe o Nginx na frente.

O que preciso guardar no backup?

O banco de dados e os anexos, mais o .env, o compose.yaml e o configuration.yml.

Esta resposta lhe foi útil?

Artigos Relacionados