Como Instalar Laravel Homestead no Windows 10

Neste post irei demonstrar como instalar o Laravel Homestead no Windows 10. Após, tentativas e erros, vou deixar aqui o melhor caminho até chegar na instalação final com um projeto Laravel rodando.

Homestead

Se você chegou até aqui, eu acredito que você já saiba o que é o Homestead e tenha algum contado com máquinas virtuais e tenha usado o Vagrant/VirtualBox.

Os procedimentos a seguir irão instalar o Homestead versão 2.1.0 contendo os seguintes softwares:

  • Ubuntu 16.04
  • Git
  • PHP 7.1
  • Nginx
  • MySQL
  • MariaDB
  • Sqlite3
  • Postgres
  • Composer
  • Node (With Yarn, Bower, Grunt, and Gulp)
  • Redis
  • Memcached
  • Beanstalkd
  • Mailhog
  • ngrok

É claro que você poderá instalar o que quiser além destes já inclusos.

Softwares Necessários

Depois de vários erros disparados quando tentava levantar o Vagrant, descobri que precisa instalar versões específicas dos softwares abaixo, do contrário, não seria possível rodar o Homestead. Mas, para sua felicidade, vou deixar o link das versões que estou usando. Use outras versões mais atualizadas ou mais antigas por sua conta e risco.

Git

O Git é necessário para clonagem do projeto Homestead que será usado para levantar o Vagrant, bem como para executar os comandos simulando um ambiente Unix-like.

Faça o download clicando no link abaixo:

32-bit Git para Windows
64-bit Git para  Windows

Para todos os casos,

  • Marque todas as opções na tela “Select Components
  • Selecione “Use Git and optional Unix tools…” na tela “Adjusting yout PATH environment
  • Selecione “Use the OpenSSL library” na tela “Choosing HTTPS transport backend
  • Selecione “Checkout as-is, commit Unix-style line endings” na tela “Configuring the line ending conversions
  • Selecione “Use MinTTY  (the default…)” na tela “Configuring the terminal emulator to use Git Bash
  • Marque todas as opções na tela “Configuring extra options
  • Prossiga…

Vagrant

O Vagrant é necessário para rodar o Homestead juntamente com o VirtualBox,

Baixe o:

Vagrant 32/64 bits para Windows

Aceite todas as opções padrão.

 

VirtualBox

O VirtualBox será utilizado para rodar o Ubuntu que vem junto com o Box do Vagrant do Homestead.

Baixe os arquivos:

Virtual Box para Windows 32/64 bits

Aceite todas as opções padrão e abra o Virtual Box. Ignore as informações de atualização.

Extensões Virtual Box para Windows

Execute este arquivo e confirme. Ignore as informações de atualização.

 

Instação do Homestead

OBS.: Você poderá modificar estes caminhos, mas faça este passo-a-passo primeiro.

Com tudo instalado acima:

  • Acesse a pasta de seu Usuário
  • Clique com o botão direito e escolha “Git Bash here“, que irá abri o terminal do git no diretório do seu usuário

Feito isso, execute o comando:

vagrant box add laravel/homestead

O comando acima irá baixar o Box do Homestead, o que poderá demorar um pouco dependendo da sua velocidade de download.

Após finalizado, será exibida uma mensagem solicitando para você informar o tipo de máquina virtual que está utilizando, escolha o número que corresponde à Virtual Box e pressione ENTER.

Crie o diretório que irá mapear os códigos do Homestead

mkdir Code

Uma vez baixado, clone o repositório do Homestead:

git clone https://github.com/laravel/homestead.git Homestead

O Git irá clonar o repositório para a pasta Homestead, e uma vez terminado, acesse-a:

cd Homestead

Agora, inicie o homestead:

bash init.sh

Quando o comando acima foi executado foi criado um arquivo de configuração “Homestead.yalm” dentro da pasta Homestead. Abra este arquivo e analise as configurações para você ter uma idéia.

Sem modificar nada além da opção “folders”, deixe o bloco de configurações assim:

folders:
    - map: ~/Code
      to: /home/vagrant/Code
      type: "nfs"
É importante destacar que “– map” corresponde à pasta dentro do Windows e “to” corresponde a pasta dentro do Ubuntu da máquina virtual.
Logo abaixo, há um site padrão que será executado pelo Nginx e que não existe um projeto ainda, apenas o apontamento:
sites:
    - map: homestead.app
      to: /home/vagrant/Code/Laravel/public
Aqui se faz mister explicar que “– map” é o URL de acesso via navegador no Windows e “to” é o local da pasta onde se encontra o arquivo de entrada do seu projeto, no caso “index.php” que o Laravel instala ao criar um projeto.
Se você quiser adicionar novos sites é só criar novas entradas “– map” e “to“.
Como se trata de Server Blocks (Virtual Hosts) do Nginx, você precisará fazer os apontamentos no arquivo hosts do Windows, que no Windows 10 se encontra na no caminho “C:\Windows\System32\drivers\etc\hosts“.  Para abrí-lo, você precisará estar com o “Bloco de Notas” aberto como Administrador. Se você nao visualizar o arquivo quando for procurá-lo no Bloco de Notas, selecione a opção “Todos os arquivos (*)” no select logo ao lado do campo Nome.
Voce deverá adicionar ao final deste arquivo o par IP (tab) URL. O IP deverá ser o mesmo que está no arquivo Homestead.yaml, no nosso caso, se seu IP for igual o meu, deverá inserir a linha:
192.168.10.10        homestead.app
Para cada novo site, faça um novo apontamento!

Com todos os procedimentos acima feitos, agora é preciso criar uma chave SSH a ser usada pelo Vagrant, executando o comando:

ssh-keygen -t rsa -C "seuemail@seusite.com"
  1. Confirme pressionando ENTER
  2. Deixe a senha vazia, e pressione ENTER
  3. ENTER novamente

Se tudo estiver certo, não havendo erros, é hora de cruzar os dedos e executar a máquina virtual do Homestead:

vagrant up

Se nenhum erro for informado, você poderá acessar a máquina via ssh:

vagrant ssh

 

Já dentro da máquina, acesse:

cd /home/vagrant/Code/

E crie um projeto Laravel:

laravel new Laravel

Aguarde finalizar, e acesse no navegador do Windows:

http://homestead.app

E você verá a tela do Laravel.

 

Bom é isso ai, se tiver algum problema, deixe nos comentários, se eu conseguir resolver, lhe notifico por e-mail.

Espero que tenha sido útil.

Abraço!

Deixe uma resposta

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *