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.
- Downloads – Oracle VM VirtualBox https://www.virtualbox.org/wiki/Downloads
Install Vagrant.
- Download - Vagrant by HashiCorp https://www.vagrantup.com/downloads.html
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: "192.168.10.10"
memory: 2048
cpus: 2
provider: virtualbox
authorize: ~/.ssh/id_rsa.pub
keys:
- ~/.ssh/id_rsa
folders:
- map: ~/code
to: /home/vagrant/code
sites:
- map: homestead.test
to: /home/vagrant/code/public
databases:
- homestead
features:
- 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.
folders:
- 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
.
sites:
- map: homestead.test
to: /home/vagrant/code/myproject/public
Add name resolution to hosts file.
$ sudo vi /etc/hosts
192.168.10.10 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.
Good Job!👍
Top comments (6)
in case you couldn't install homestead using
you can use the following :
Thanks for your reply! I added your command to this article.
Nice tutorial, more straightforward step and easy to follow.
Thanks a lot!
Nice tutorial but you missed the OS X permission issue steps.
can you elaborate on that please?
I have this issue when using vagrant with virtualbox
`
The guest machine entered an invalid state while waiting for it
to boot. Valid states are 'starting, running'. The machine is in the
'aborted' state. Please verify everything is configured
properly and try again.
If the provider you're using has a GUI that comes with it,
it is often helpful to open that and watch the machine, since the
GUI often has more helpful error messages than Vagrant can retrieve.
For example, if you're using VirtualBox, run
vagrant up
while theVirtualBox GUI is open.
The primary issue for this error is that the provider you're using
is not properly configured. This is very rarely a Vagrant issue.`