Be part of JetBrains PHPverse 2026 on June 9 – a free online event bringing PHP devs worldwide together.

victordelaunay's avatar

Box 'laravel/homestead' could not be found.

Hi! I am attempting to install the latest Homestead box with Vagrant and Virtualbox.

Homestead 11.1.2

Vagrant 2.2.10

VirtualBox 6.1.14 r140239 (Qt5.6.3)

I ran vagrant box add laravel/homestead and got the following input:

==> box: Loading metadata for box 'laravel/homestead'
    box: URL: https://vagrantcloud.com/laravel/homestead
This box can work with multiple providers! The providers that it
can work with are listed below. Please review the list and choose
the provider you will be working with.

1) hyperv
2) parallels
3) virtualbox
4) vmware_desktop

Enter your choice: 3
==> box: Adding box 'laravel/homestead' (v10.1.0) for provider: virtualbox
    box: Downloading: https://vagrantcloud.com/laravel/boxes/homestead/versions/10.1.0/providers/virtualbox.box
Download redirected to host: vagrantcloud-files-production.s3.amazonaws.com
    box: Calculating and comparing box checksum...
==> box: Successfully added box 'laravel/homestead' (v10.1.0) for 'virtualbox'!

When I run vagrant box list I get:

laravel/homestead (virtualbox, 10.1.0)

But as soon as I run vagrant up it doesn't find the box and defaults to download the version 9.6.0 of Homestead:

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.0
==> homestead: Loading metadata for box 'laravel/homestead'
    homestead: URL: https://vagrantcloud.com/laravel/homestead
==> homestead: Adding box 'laravel/homestead' (v9.6.0) for provider: virtualbox
    homestead: Downloading: https://vagrantcloud.com/laravel/boxes/homestead/versions/9.6.0/providers/virtualbox.box
==> homestead: Box download is resuming from prior download progress
Download redirected to host: vagrantcloud-files-production.s3.amazonaws.com
    homestead: Calculating and comparing box checksum...
==> homestead: Successfully added box 'laravel/homestead' (v9.6.0) for 'virtualbox'!
==> homestead: Importing base box 'laravel/homestead'...


==> homestead: Matching MAC address for NAT networking...
==> homestead: Checking if box 'laravel/homestead' version '9.6.0' is up to date...

... 
0 likes
2 replies
newbie360's avatar

if you following the steps on the Laravel online doc

after

vagrant box add laravel/homestead

then (you may delete the ~/Homestead folder, do it again from here)

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

check the GitHub Release Page: https://github.com/laravel/homestead/releases type

git checkout v11.2.2
bash init.sh

make a ssh key and edit the Homestead.yaml and vagrant up

xenus's avatar

I have the same issue and got it solved by NewBie360's answer!

Please or to participate in this conversation.