Base de Conhecimento

Ruby on Rails na VPS: como publicar seu projeto com Nginx

  • ruby on rails, rails, puma, nginx, systemd, vps
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Ruby on Rails na VPS: como publicar seu projeto com Nginx

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.

Esta resposta lhe foi útil?

Artigos Relacionados