Skip to content

Instantly share code, notes, and snippets.

@idecardo

idecardo/homestead-manual-install.md

Last active April 16, 2026 10:41
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save idecardo/deec25b8fa54976edb496d7ce7d320a7 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save idecardo/deec25b8fa54976edb496d7ce7d320a7 to your computer and use it in GitHub Desktop.
Download ZIP
Laravel Homestead Manual Installation
Raw
homestead-manual-install.md

Getting Started

Laravel Homestead is an official, pre-packaged Vagrant box that provides you a wonderful development environment without requiring you to install PHP, HHVM, a web server, and any other server software on your local machine. Read more...

Download

Download homestead box:

https://app.vagrantup.com/laravel/boxes/homestead/versions/9.5.1/providers/virtualbox.box

You can change the version of homestead box. Current version: 9.5.1.

After downloading the box, rename it to virtualbox.box or whatever name you like.

Don't forget to include the .box extension.

Vagrant

Add the downloaded homestead box to vagrant:

vagrant box add laravel/homestead file:///c:/users/idecardo/downloads/virtualbox.box

Change the path to where you stored your downloaded homestead box.

Update homestead box

Navigate to vagrant directory:

c:/users/idecardo/.vagrant.d/boxes/laravel-VAGRANTSLASH-homestead

Create a metadata_url file and add this link:

https://app.vagrantup.com/laravel/boxes/homestead

Do not add a newline.

Rename folder 0 to 9.5.1

9.5.1 is your homestead box version.

Alternative

Using gitbash, within c:/users/idecardo/.vagrant.d/boxes/laravel-VAGRANTSLASH-homestead directory:

touch metadata_url
echo -n 'https://app.vagrantup.com/laravel/boxes/homestead' > metadata_url
mv 0 9.5.1
@sithuaung

sithuaung commented Oct 10, 2016

Copy link
Copy Markdown

@idecardo very helpful... Thank you very much

@JoseCage

JoseCage commented Nov 19, 2016

Copy link
Copy Markdown

Thanks.. I will try..

@HosMercury

HosMercury commented Mar 13, 2017

Copy link
Copy Markdown

does this for mac?

@bsienn-khan

bsienn-khan commented May 25, 2017

Copy link
Copy Markdown

Thanks mate for this.

And how difficult was this for the Laravel/Homestead team to explain?

Why they keep everything so complicated, It was meant to make development easy, instead it made it worse, Not everyone have high speed internet and Installing on many PC would be really stupid the way they do.

@arthurtaras

arthurtaras commented Jul 10, 2017

Copy link
Copy Markdown

Many thanks from behind Chinese firewall here ;D

@vesper8

vesper8 commented Jul 25, 2017

Copy link
Copy Markdown

Thanks a lot! This works on Mac sierra.

Only thing though is that when I did my first 'vagrant up' it complained about being unable to check the metadata because of "illegal characters found in url"

I made sure not to include a line return but I think my editor might add one by default

@haoxi911

haoxi911 commented Sep 18, 2017

Copy link
Copy Markdown

@vesper8 I saw the same warning here, have you found a solution to it? Thanks!

ghost commented Nov 1, 2017

Copy link
Copy Markdown

Please i have installed vagrant and i have changed the folder from 0 to 4.0.0 but when i vagrant up it show this error

The provider 'virtualbox' that was requested to back the machine
'homestead-7' is reporting that it isn't usable on this system. The
reason is shown below:

Vagrant has detected that you have a version of VirtualBox installed
that is not supported by this version of Vagrant. Please install one of
the supported versions listed below to use Vagrant:

4.0, 4.1, 4.2, 4.3, 5.0, 5.1

A Vagrant update may also be available that adds support for the version
you specified. Please check www.vagrantup.com/downloads.html to download
the latest version.

Please i need help

@YahzeeSkellington

YahzeeSkellington commented Nov 2, 2017 •
edited
Loading

Copy link
Copy Markdown

@kelvinrolex I solved that issue with the fix discussed here: hashicorp/vagrant#9090

ghost commented Nov 2, 2017

Copy link
Copy Markdown

@YahzeeSkellington, thanks so much... Problem solved.

@thofik93

thofik93 commented Jan 20, 2018

Copy link
Copy Markdown

thankyou so much bro!

@lucasctd

lucasctd commented Feb 6, 2018

Copy link
Copy Markdown

Hi @idecardo, the main domain has changed to https://app.vagrantup.com. Then, it should be downloaded now through: https://app.vagrantup.com/laravel/boxes/homestead/versions/5.1.0/providers/virtualbox.box

Thanks. =D

*5.1.0 is currently the latest version of Laravel Homestead box.

@ibrahimi3

ibrahimi3 commented Apr 12, 2018

Copy link
Copy Markdown

@idecardo That works fine with the 5.2.0 release also. Thank you!

@rameshnavi

rameshnavi commented Apr 19, 2018

Copy link
Copy Markdown

Works like charm!

Downloading boxes offline is way faster than vagrant add ...

@fide1

fide1 commented May 5, 2018

Copy link
Copy Markdown

or you can download directly from this drive https://onedrive.live.com/?authkey=%21AGNBKHeCev0M1x4&id=CAE7E9182E2886E1%21246481&cid=CAE7E9182E2886E1

@idecardo

idecardo commented Sep 28, 2018 •
edited
Loading

Copy link
Copy Markdown
Author

@lucasctd thanks! I've updated the gist to reflect the updated domain.

@asamofal

asamofal commented Apr 19, 2019

Copy link
Copy Markdown

Create a metadata_url file and add this link:
https://app.vagrantup.com/laravel/homestead

The link has been changed. Valid link for now is https://app.vagrantup.com/laravel/boxes/homestead

@ShakalakaB

ShakalakaB commented Nov 12, 2019

Copy link
Copy Markdown

really help a lot, thank

@sajjadanwar0

sajjadanwar0 commented Jan 6, 2020 •
edited
Loading

Copy link
Copy Markdown

The link is now changed .New link for virtual box:
https://vagrantcloud.com/laravel/boxes/homestead/versions/9.2.2-alpha1/providers/virtualbox.box

@slyang-git

slyang-git commented Apr 11, 2020

Copy link
Copy Markdown

that's worked for me. thanks lots.

@ilhamsj

ilhamsj commented Jun 26, 2020

Copy link
Copy Markdown

when i run vagrant up download again like before

C:\Users\ilhamsj\Homestead>vagrant up
Bringing machine 'homestead' up with 'virtualbox' provider...
==> homestead: Box 'laravel/homestead' could not be found. Attempting to find and install...
    homestead: Box Provider: virtualbox
    homestead: Box Version: >= 9.5.0
==> homestead: Loading metadata for box 'laravel/homestead'
    homestead: URL: https://vagrantcloud.com/laravel/homestead
==> homestead: Adding box 'laravel/homestead' (v10.0.0-beta) for provider: virtualbox
    homestead: Downloading: https://vagrantcloud.com/laravel/boxes/homestead/versions/10.0.0-beta/providers/virtualbox.box
==> homestead: Box download is resuming from prior download progress
Download redirected to host: vagrantcloud-files-production.s3.amazonaws.com
Progress: 0% (Rate: 33352/s, Estimated time remaining: 3:11:16)

@idecardo

idecardo commented Jul 5, 2020

Copy link
Copy Markdown
Author

@asamofal thanks! I've updated the gist to reflect the updated link.

@adibpwd

adibpwd commented Apr 24, 2022

Copy link
Copy Markdown

when i run vagrant up download again like before

C:\Users\ilhamsj\Homestead>vagrant up
Bringing machine 'homestead' up with 'virtualbox' provider...
==> homestead: Box 'laravel/homestead' could not be found. Attempting to find and install...
    homestead: Box Provider: virtualbox
    homestead: Box Version: >= 9.5.0
==> homestead: Loading metadata for box 'laravel/homestead'
    homestead: URL: https://vagrantcloud.com/laravel/homestead
==> homestead: Adding box 'laravel/homestead' (v10.0.0-beta) for provider: virtualbox
    homestead: Downloading: https://vagrantcloud.com/laravel/boxes/homestead/versions/10.0.0-beta/providers/virtualbox.box
==> homestead: Box download is resuming from prior download progress
Download redirected to host: vagrantcloud-files-production.s3.amazonaws.com
Progress: 0% (Rate: 33352/s, Estimated time remaining: 3:11:16)

i'm too, is you solved this?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment