Cover image for Installing Laravel Homestead on MacOS🔧

Installing Laravel Homestead on MacOS🔧

ko31 profile image Ko Takagi Updated on ・2 min read

Laravel Homestead is official local development environment.
It is a great tool that allows you to easily create an environment with all the functions required for development.

The following is the steps for installing Laravel 6.x on MacOS with Homestead.

Install VirtualBox.

Install Vagrant.

Install the Homestead Vagrant box.

$ vagrant box add laravel/homestead

By the way, if you couldn't install homestead above command, you can use the following:

$ vagrant box add laravel/homestead https://vagrantcloud.com/laravel/homestead 

Install Homestead.

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

Create the Homestead configration file.

$ cd ~/Homestead
$ bash init.sh

Homestead.yaml is created in the directory.

$ cat Homestead.yaml
ip: ""
memory: 2048
cpus: 2
provider: virtualbox

authorize: ~/.ssh/id_rsa.pub

    - ~/.ssh/id_rsa

    - map: ~/code
      to: /home/vagrant/code

    - map: homestead.test
      to: /home/vagrant/code/public

    - homestead

    - mariadb: false
    - ohmyzsh: false
    - webdriver: false

# ports:
#     - send: 50000
#       to: 5000
#     - send: 7777
#       to: 777
#       protocol: udp

View the folders property of the Homestead.yaml file.

    - map: ~/code
      to: /home/vagrant/code

Create directory according to settings.

$ mkdir ~/code

Edit the sites property of the Homestead.yaml file. In the case, the project directory name is myproject.

    - map: homestead.test
      to: /home/vagrant/code/myproject/public

Add name resolution to hosts file.

$ sudo vi /etc/hosts homestead.test

Launch Vagrant.

$ cd ~/Homestead
$ vagrant up

If there are not id_rsa (secret key) and id_rsa.pub (public key) in ~/.ssh directory, create key files.

$ ssh-keygen -t rsa

Connect to virtual machine using SSH.

$ vagrant ssh

Install Laravel with project name myproject.

$ cd ~/code
$ composer create-project --prefer-dist laravel/laravel myproject

View homestead.test in your browser.

Welcome to Laravel

Good Job!👍

Posted on by:

ko31 profile

Ko Takagi


I am freelance web engineer in Japan. Since I am studying English, I started writing articles here😆 I want to play catch! ⚾️


markdown guide

in case you couldn't install homestead using

vagrant box add laravel/homestead 

you can use the following :

vagrant box add laravel/homestead https://vagrantcloud.com/laravel/homestead 

Thanks for your reply! I added your command to this article.


Nice tutorial, more straightforward step and easy to follow.