Setup de Ambiente: Windows + WSL + Ruby on Rails

Guia passo a passo para configurar um ambiente de desenvolvimento Ruby on Rails no Windows usando WSL (Windows Subsystem for Linux).

Regra de ouro: mantenha sempre os projetos dentro do sistema de arquivos do Linux (/home/...), nunca em /mnt/c/.... O acesso a arquivos via /mnt/c é muito mais lento e causa problemas com file watchers do Rails.

1. Instalar o WSL

Pré-requisitos do Windows

Antes de instalar o WSL, verifique e ajuste as seguintes configurações:

Versão do Windows O WSL 2 requer Windows 10 versão 2004 (build 19041) ou superior, ou Windows 11. Confira em Configurações → Sistema → Sobre.

Recursos do Windows Habilite os dois recursos abaixo em Painel de Controle → Programas → Ativar ou desativar recursos do Windows:

✅ Subsistema do Windows para Linux
✅ Plataforma de Máquina Virtual

Ou ative via PowerShell (como Administrador):

dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Virtualização no BIOS/UEFI Certifique-se de que a virtualização está habilitada na BIOS/UEFI do seu computador (Intel VT-x ou AMD-V). Você pode confirmar no Gerenciador de Tarefas → aba Desempenho → CPU: deve aparecer "Virtualização: Habilitada".

Reinicie o computador antes de prosseguir caso tenha ativado algum dos recursos acima.

Instalação

No PowerShell aberto como Administrador:

wsl --install -d Ubuntu-26.04

Crie o usuário e a senha do Linux quando solicitado. Reinicie o computador se o sistema pedir.

2. Atualizar o sistema (no terminal do Ubuntu/WSL)

Antes de instalar qualquer coisa, atualize os pacotes do sistema:

sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y

Aguarde a conclusão. Se solicitado, reinicie o terminal.

3. Instalar Ruby on Rails (no terminal do Ubuntu/WSL)

Baixe o script de instalação (rbenv + Ruby + Rails):

wget https://gist.githubusercontent.com/alexishida/655fb139c759393ae5fe47dacd163f99/raw/fd4a5af496a45b639358b91fa7663642be53b7e1/rbenv-ruby-rails-install.sh

Dê permissão de execução e rode o script:

chmod +x rbenv-ruby-rails-install.sh
sudo ./rbenv-ruby-rails-install.sh

Feche e reabra o terminal. Em seguida, verifique se a instalação funcionou:

ruby -v
rails -v

Criar e abrir o projeto

rails new nome_projeto
cd nome_projeto
code .

4. Configurar o VS Code

Instale as seguintes extensões:

WSL (Microsoft) — permite editar e rodar o projeto direto dentro do ambiente Linux.
A IA que for usar: Claude ou Codex.

5. OpenSpec (no WSL)

npm install -g @fission-ai/openspec@latest
cd nome_projeto
openspec init

Depois, dentro do Codex ou Claude, execute:

/opsx:propose

6. Configurar o Git (no WSL)

Configuração inicial (apenas uma vez)

git config --global color.ui true
git config --global user.name "SEU NOME"
git config --global user.email "SEU@EMAIL.com"

Gerar a chave SSH e conectar ao GitHub

ssh-keygen -t ed25519 -C "SEU@EMAIL.com"
cat ~/.ssh/id_ed25519.pub

Copie o conteúdo exibido pelo cat e adicione em GitHub → Settings → SSH and GPG keys → New SSH key.

Por fim, teste a conexão:

ssh -T git@github.com

7. Docker

Siga a documentação oficial para instalar e configurar o Docker no Ubuntu:

Instalação: https://docs.docker.com/engine/install/ubuntu/
Pós-instalação (rodar Docker sem sudo): https://docs.docker.com/engine/install/linux-postinstall/

alexishida/tutorial-ambiente-rails-wsl.md

Select an option

No results found