PauloRB.dev

Como rodar Laravel no WSL com Valet Linux (de verdade)

Por Paulo RB em 20/07/2025

Sim, dá pra desenvolver Laravel no Windows sem sofrer. Mas você precisa fazer do jeito certo: usando WSL + Valet Linux.

Esqueça XAMPP, Laragon, Docker lento e até o WSL 1. O caminho mais fluido para trabalhar com Laravel no Windows hoje é rodar o ambiente nativamente no Linux, dentro do Windows, com o poder do Valet.

Spoiler: no final você acessa http://meusite.test no Chrome como se estivesse no Linux nativo. E funciona rápido.

Pré-requisitos

• Windows 10/11

• WSL2 habilitado

• Ubuntu instalado no WSL

• PHP 8.3+

• Composer

• Git

Se não tem isso ainda, instala o WSL aqui primeiro.

1. Instalando o Valet Linux

composer global require cpriego/valet-linux

Adicione o bin do composer ao seu PATH no ~/.bashrc ou ~/.zshrc:

export PATH="$HOME/.config/composer/vendor/bin:$PATH"

Depois rode:

valet install

Erro? Provavelmente ele pediu algumas dependências. Instala elas:

sudo apt install jq xsel libnss3-tools -y

E instala o NGINX também, caso não esteja:

sudo apt install nginx dnsmasq -y

Aí sim:

valet install

2. Criando e servindo seus projetos Laravel

Crie uma pasta para seus projetos:

mkdir ~/Desenvolvimento
cd ~/Desenvolvimento
valet park

Agora crie ou clone seu projeto:

laravel new corretagem-novo
cd corretagem-novo
valet link

Acesse:

http://corretagem-novo.test

Sim. .test funcionando, direto no navegador do Windows.

3. “DNS_PROBE_FINISHED_NXDOMAIN”? É o WSL…

Você precisa mapear o domínio .test para o IP do WSL no Windows.

No terminal WSL:

ip addr show eth0 | grep inet

Vai dar algo como:

inet 172.28.81.23/20 ...

Copie o IP.

Agora, no Windows, edite o arquivo hosts como administrador:

C:\Windows\System32\drivers\etc\hosts

Adicione:

172.28.81.23  corretagem-novo.test

Bonus: Dicas rápidas

• valet use 8.2>=: troca a versão do PHP

• valet secure meuapp: ativa HTTPS pro projeto

• valet tinker: shell PHP direto

• valet share: ngrok instantâneo (para mostrar o projeto ao cliente)