Ruby on Rails na VPS: como publicar seu projeto com Nginx
Publique o Rails na VPS pelo caminho manual: Ruby com Mise, Puma como serviço do systemd, Nginx na frente, HTTPS e os cuidados com segredos e banco.
Por Redação Eleven Host · @robson.direitodigital · 6 de novembro de 2026 · 10 min de leitura

Capa da Redação Eleven Host para o guia: Ruby on Rails na VPS: como publicar seu projeto com Nginx Arte: Eleven Host
Ruby on Rails na VPS tem dois caminhos, e o guia oficial do Rails publica com Kamal. Este é o caminho manual, com Puma, Nginx e systemd: versões, banco, segredos, HTTPS e os cuidados de cada etapa.
Atualizado em 06/11/2026. Na data deste guia, a versão mais recente do Rails é a 8.1.4.1, publicada em 04/11/2026 como versão de segurança: o anúncio oficial fala em 21 problemas de segurança corrigidos, entre eles falhas no Active Storage e falsificação de IP pelo cabeçalho Forwarded (só na série 8.1), e recomenda atualizar o quanto antes. Nessa mesma data, o Ruby estável é o 4.0.9, o Puma está na 8.0.2 e o Kamal na 2.12.0. Trate esses números como um retrato do dia.
Kamal ou montagem manual
O guia de primeiros passos do Rails traz um capítulo de publicação em produção, e ele usa o Kamal. As notas do Rails 8 dizem que o framework já vem preparado com o Kamal 2 para publicar em um servidor Linux novo. O Kamal pede um Dockerfile na raiz do projeto, um registro de imagens, acesso por SSH, o Docker instalado no servidor e um proxy próprio, o kamal-proxy, que escuta nas portas 80 e 443.
O caminho deste guia é outro: você instala o Ruby no servidor, roda o Puma como serviço do systemd e coloca o Nginx na frente. Como o kamal-proxy e o Nginx disputam as portas 80 e 443, recomendamos escolher um caminho só no mesmo servidor. Se você ainda está escolhendo o servidor, o guia completo de servidor VPS explica o que é uma VPS e como escolher o plano. Os comandos aqui supõem Ubuntu 22.04 ou mais novo, o mínimo do guia oficial de instalação do Rails.
Certificado primeiro, force_ssl depois. Ligar o force_ssl antes de emitir o certificado pode impedir o acesso ao site, e o navegador guarda o aviso de HTTPS por um tempo. Siga a ordem da seção de HTTPS.
Ruby no servidor
O guia oficial instala o Ruby com o Mise, um gerenciador de versões. Ele explica que o sistema pode trazer um Ruby já instalado, mas que muitas vezes está desatualizado e não pode ser atualizado. Um exemplo de comandos, copiados do guia oficial, para conferir no seu servidor:
sudo apt update
sudo apt install build-essential rustc libssl-dev libyaml-dev zlib1g-dev libgmp-dev git
curl https://mise.run | sh
echo 'eval "$(~/.local/bin/mise activate)"' >> ~/.bashrc
source ~/.bashrc
mise use -g ruby@3
ruby -v
O curl ... | sh executa um script baixado da internet. Como alternativa, o README do rbenv diz que o pacote do apt está desatualizado e recomenda instalar por git, junto com o plugin ruby-build.
Escolha a versão com cuidado. A página do Rubygems mostra que o Rails 8.1.4.1 aceita Ruby a partir da 3.2, mas a série 3.2 do Ruby está encerrada desde 01/04/2026, então não recomendamos começar nela. A série 3.3 recebe só correções de segurança, com fim previsto para 31/03/2027, e as séries 3.4 e 4.0 estão em manutenção normal. Recomendamos, no mínimo, a 3.3. Para versões mais novas, confira se a sua versão do Rails já foi testada com elas, e use ruby -v para ver qual versão o Mise instalou.
Para publicar um app que já existe, o gem install rails do guia oficial não é necessário: o Gemfile do projeto já traz o Rails.
Uma VPS entra nas suas contas? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Código, gems e assets
Segundo o guia de implantação do Rubygems, o bundle install --deployment instala as gems em vendor/bundle e exige o arquivo Gemfile.lock, falhando se ele não existir. Confira no seu servidor o que a versão instalada do Bundler aceita.
Para os assets, o Rails 8 inclui o Propshaft por padrão, e a compilação copia os arquivos para public/assets. Um exemplo de comando:
RAILS_ENV=production rails assets:precompile
A variável RAILS_ENV define em qual ambiente o Rails roda. O guia de migrações mostra a troca dela com o ambiente de teste, e a forma com production é a troca do valor. Um exemplo de comando para as migrações:
bin/rails db:migrate RAILS_ENV=production
O Rails também tem o db:prepare, que é idempotente e, num banco inexistente, age como db:setup. Para as publicações seguintes, recomendamos o db:migrate, que é o comando de migração.
Segredos e banco de dados
O Rails guarda os segredos em config/credentials.yml.enc, um arquivo criptografado, editado com bin/rails credentials:edit. A chave que abre esse arquivo é o config/master.key, ou a variável de ambiente RAILS_MASTER_KEY. O guia de segurança do Rails pede que você guarde essa chave com cuidado e não faça commit dela. A opção config.require_master_key faz o app não iniciar se a chave não estiver disponível, e o comando bin/rails secret gera um segredo novo.
master.key fora do Git
Confira o .gitignore antes do primeiro commit e não cole a chave em chat, ticket ou documento. No servidor, recomendamos entregar a chave ao serviço por um arquivo só seu, apontado por EnvironmentFile= na unit do systemd, com permissão restrita.
Quanto ao banco, um projeto novo do Rails usa SQLite por padrão. O guia de configuração avisa que o Rails configura melhor o SQLite para produção, mas que um ambiente movimentado pode sobrecarregá-lo. O modelo de configuração pede disco persistente e divide a produção em quatro bancos: primary, cache, queue e cable. Se o seu app vai ter muito acesso, avalie um banco como o MySQL ou o PostgreSQL; o guia de Flask na VPS e o guia de Django na VPS seguem a mesma ideia de app Python atrás de Nginx e podem servir de comparação.
Puma e systemd
O Puma escuta em uma porta ou em um socket Unix, e o README dele mostra o socket com -b. Um exemplo de config/puma.rb, com o socket no lugar da porta, para conferir no seu servidor:
threads_count = ENV.fetch("RAILS_MAX_THREADS", 3)
threads threads_count, threads_count
bind "unix:///home/deploy/meuapp/tmp/sockets/puma.sock"
Um cuidado: chamar bind não substitui as ligações anteriores, e a linha port do modelo do Rails também vira uma ligação. Se você só acrescenta o socket, o app segue escutando na porta 3000. O padrão de bind é escutar nos endereços da máquina, e a port provavelmente faz o mesmo, então remova a linha port ou use 127.0.0.1.
A documentação do Puma traz uma unit do systemd com Type=notify, que o Puma aceita desde a versão 5.1, e pede caminho absoluto no ExecStart; uma opção é gerar o executável com bundle binstubs puma --path ./sbin. Um exemplo de unit adaptada, para conferir no seu servidor. O usuário, as pastas e o caminho do Ruby (do Mise ou do rbenv) são ilustrativos:
[Unit]
Description=Puma do meuapp
After=network.target
[Service]
Type=notify
WatchdogSec=10
User=deploy
WorkingDirectory=/home/deploy/meuapp
Environment=RAILS_ENV=production
EnvironmentFile=/etc/meuapp.env
ExecStart=/home/deploy/meuapp/sbin/puma -C /home/deploy/meuapp/config/puma.rb
Restart=always
[Install]
WantedBy=multi-user.target
A documentação do Puma recomenda configurar um usuário sem privilégios, por isso o exemplo usa User=deploy. Antes de ativar, crie a pasta tmp/sockets do projeto e o arquivo /etc/meuapp.env, com a RAILS_MASTER_KEY e o PATH que inclui o Ruby do Mise ou do rbenv: o systemd não lê o seu ~/.bashrc, e o serviço não sobe sem o Ruby e sem esse arquivo. Depois de salvar a unit em /etc/systemd/system/meuapp.service, rode sudo systemctl daemon-reload e sudo systemctl enable --now meuapp.
Nginx na frente
O exemplo de Nginx da documentação do Puma é antigo, vem de uma receita de Capistrano e não tem porta 443 nem o cabeçalho X-Forwarded-Proto. Por isso, o bloco abaixo é um exemplo enxuto, com try_files, e o domínio é fictício. Confira no seu servidor antes de recarregar o Nginx:
upstream meuapp {
server unix:/home/deploy/meuapp/tmp/sockets/puma.sock;
}
server {
listen 80;
server_name app.exemplo.com.br;
root /home/deploy/meuapp/public;
location / {
try_files $uri @puma;
}
location @puma {
proxy_pass http://meuapp;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
O usuário do Nginx precisa conseguir acessar o socket e a pasta public. O README do Puma mostra a opção umask na linha de bind do socket para ajustar essa permissão. Se você já publicou outro framework nesse formato, o guia de Laravel na VPS mostra o mesmo desenho, com Nginx na frente do projeto.
HTTPS e hosts
Com o domínio apontando para o servidor, o Certbot da EFF instala o certificado no Nginx. A página dele, para Nginx em Linux por snap, traz os comandos abaixo, e pede remover antes um Certbot instalado por pacote do sistema com sudo apt-get remove certbot:
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/local/bin/certbot
sudo certbot --nginx
sudo certbot renew --dry-run
Só depois do certificado funcionando, ligue o config.force_ssl, que força as requisições a usarem HTTPS. No modelo do ramo principal do Rails, o assume_ssl e o force_ssl ficam ativos apenas em apps gerados sem o Kamal e vêm comentados no padrão, então confira as duas linhas no seu production.rb e descomente se for o caso. O assume_ssl faz o app tratar as requisições como HTTPS, o que ajuda quando um proxy encerra o SSL. O bloco do Nginx acima envia o X-Forwarded-Proto; se aparecer laço de redirecionamento, confira esse cabeçalho e o assume_ssl.
Liste os hosts permitidos
Em produção, a lista config.hosts vem vazia e o Rails não valida o cabeçalho Host. O guia de segurança recomenda o middleware ActionDispatch::HostAuthorization contra ataques de DNS rebinding. Coloque o seu domínio na lista.
Publicar uma atualização
Para cada nova versão do código, repita o ciclo: baixar o código, instalar as gems, compilar os assets, migrar o banco e reiniciar o serviço. Um exemplo de sequência, para ajustar ao seu projeto:
git pull
bundle install
RAILS_ENV=production rails assets:precompile
bin/rails db:migrate RAILS_ENV=production
sudo systemctl restart meuapp
Se você usa o Rails 8.0, a série perde o suporte de segurança em 07/11/2026, um dia depois da data deste guia. A série 8.1 recebe correções de segurança até 10/10/2027; a correção de bugs dela terminou em 10/10/2026.
Para ir adiante
Com o app no ar, o trabalho passa a ser acompanhar os avisos de segurança do Rails e do Ruby e atualizar as versões.
Vale olhar os planos de servidor virtual da Eleven Host? VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos
Perguntas frequentes
O guia oficial do Rails usa Nginx?
O capítulo de produção do guia oficial usa o Kamal, e a documentação do Kamal diz que o kamal-proxy escuta nas portas 80 e 443. A montagem com Puma, Nginx e systemd deste artigo é um caminho manual, escolhido por quem quer controlar o servidor.
Posso usar o Kamal e o Nginx no mesmo servidor?
Os dois disputam as portas 80 e 443. Recomendamos escolher um caminho só, a menos que você ajuste as portas de um deles.
O SQLite serve para produção no Rails?
O guia de configuração do Rails avisa que um ambiente movimentado pode sobrecarregá-lo. Para um app com pouco acesso e disco persistente, ele pode ser uma escolha; confira o seu caso.
Onde guardo a master.key?
Fora do Git, num arquivo com permissão restrita no servidor, ou na variável RAILS_MASTER_KEY. O guia de segurança do Rails pede para não fazer commit dela.