Skip to main content

Steps to install Homestead on OSX/Linux using Vagrant

Jose CerrejonAbout 2 minDeveloperDeveloper

Steps to install Homestead on OSX/Linux using Vagrant


Today I get a little shaken the general theme of the blog to take some notes and remember the steps on something that is trivial for a developer.

This month I have to pick a project based on Laravelopen in new window (A PHP framework for who does not know) and to be honest, do not touch the web development since last summer. So the first thing I'll do is to install Vagrant to avoid the use of LAMP/MAMP and generate unnecessary resources on my ancient iMac. Ready?...

  1. Install manually vagrantopen in new window and VirtualBoxopen in new window.

  2. Install [composer][( and type the next command to config the environment:

curl -sS | php
sudo mv composer.phar /usr/local/bin/
nano ~/.bash_profile and add:
alias composer="php /usr/local/bin/composer.phar"
sudo nano /etc/paths and add:
ssh-keygen -t rsa -C "you@homestead"
sudo nano /etc/hosts and add:
  1. Open new terminal and download Homestead:
vagrant box add laravel/homestead
composer global require "laravel/homestead=~2.0"
  1. Open a new terminal and run: homestead init and homestead edit if you want to edit the configuration file (optional). For example, you would change the path on folders - map: and sites: to: with your project path.

  2. Now run homestead up and test openning your web browser: http://homestead.appopen in new window

Some usefull commads:

     box             manages boxes: installation, removal, etc.
     connect         connect to a remotely shared Vagrant environment
     destroy         stops and deletes all traces of the vagrant machine
     global-status   outputs status Vagrant environments for this user
     halt            stops the vagrant machine
     help            shows the help for a subcommand
     init            initializes a new Vagrant environment by creating a Vagrantfile
     login           log in to HashiCorp's Atlas
     package         packages a running vagrant environment into a box
     plugin          manages plugins: install, uninstall, update, etc.
     port            displays information about guest port mappings
     powershell      connects to machine via powershell remoting
     provision       provisions the vagrant machine
     push            deploys code in this environment to a configured destination
     rdp             connects to machine via RDP
     reload          restarts vagrant machine, loads new Vagrantfile configuration
     resume          resume a suspended vagrant machine
     share           share your Vagrant environment with anyone in the world
     snapshot        manages snapshots: saving, restoring, etc.
     ssh             connects to machine via SSH
     ssh-config      outputs OpenSSH valid configuration to connect to the machine
     status          outputs status of the vagrant machine
     suspend         suspends the machine
     up              starts and provisions the vagrant environment
     version         prints current and latest Vagrant version


Link: [ > homestead](

Link: [Vagrant](