Skip to content

Setting Up Homestead

Setting up homestead#

homestead is a virtual machine. A virtual environment suited for laravel.

It has everything installed on it that needs to be installed for a laravel application and is a reusable, idempotent environment.

It uses vagrant

Lets go#

  1. Install Vagrant

  2. Install laravel

  3. Require Homestead from composer

composed global require "laravel/homestead=~2.0"
  1. Add the vagrant box
vagrant box add laravel/homestead
  1. Initialise
homestead init

This does all the tricky stuff like stting up shared folders, SSH keys and the like.

This process creates a file called ~/.homestead/homestead.yml which defines your setup.

  1. Set your local dev folder in homestead.yml

  2. Run homestead

homestead up

You can now visit your site at localhost:8000

  1. Setup your local host file
sudo vim /etc/hosts

Change to the following: homestead.App
  1. If you change settings or add multiple sites I think you will need to destory and restart the whole thing:
homestead destroy
homestead up

SSH into the Box#

You might want to SSH into the box which can be achieved with:

ssh vagrant@localhost -p 2222

The details can be retrived just like avagrant box with:

homestead ssh-config
vagrant ssh-config