Redmine na VPS: gestão de projetos no seu servidor
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

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.