Building Homestead in 2022

This post has previously been published at https://joeferguson.me/building-homestead-in-2022/

There are two parts to the Homestead product: a base box named Laravel Settler and a run time Laravel Homestead. From the Settler repo, we’re able to build base boxes Homestead, Homestead-ARM, and Homestead-MariaDB.

What do you need?

You need Packer and a Virtualization provider. You can likely build Homestead base boxes for Virtualbox, Parallels, and sometimes Hyper-V and VMware. You'll want to clone laravel/settler and chef/bento to the same parent folder.

Prepare the repositories for a fresh build

Commands to stash any changes and pull fresh copies of bento and settler repositories

Commands to stash any changes and pull fresh copies of bento and settler repositories.

Always remember to reset your directories before beginning any new builds.

Configure the Settler Build

The first section of the scripts/amd64.sh or scripts/arm.sh scripts describes the base options. The script is broken into sections of PHP, MySQL, MariaDB, and PostgreSQL. By default, we install each except MariaDB as our configuration specifies. We also get a debug output at the start of our run so we can see what our configured options were. Change these options to your desired state or continue with the defaults.

#!/usr/bin/env bash
export DEBIAN_FRONTEND=noninteractive

ARCH=$(arch)

SKIP_PHP=false
SKIP_MYSQL=false
SKIP_MARIADB=true
SKIP_POSTGRESQL=false

echo "### Settler Build Configuration ###"
echo "ARCH             = ${ARCH}"
echo "SKIP_PHP         = ${SKIP_PHP}"
echo "SKIP_MYSQL       = ${SKIP_MYSQL}"
echo "SKIP_MARIADB     = ${SKIP_MARIADB}"
echo "SKIP_POSTGRESQL  = ${SKIP_POSTGRESQL}"
echo "### Settler Build Configuration ###"

Link the Settler Build Script

Run ./bin/link-to-bento.sh (Linux, macOS) or ./link-to-bento.ps1 (Windows) to create links into the bento repository.

Linking the settler build scripts to bento repository

Linking the settler build scripts to bento repository.

Run `packer build...`

An example to build for VirtualBox would be:

$ packer build --only=virtualbox-iso ubuntu-20.04-amd64.json

If this is your first time experimenting with packer you will likely want to use --on-error=abort so that the virtual machine is left running if an error is raised so you can inspect the running machine state. By default, the virtual machine will always be cleaned up (deleted). The full help on the flag is on-error=[cleanup|abort|ask|run-cleanup-provisioner] If the build fails do: clean up (default), abort, ask, or run-cleanup-provisioner.

An example to build VirtualBox and Parallels would be:

$ packer build --only-virtualbox-iso,parallels-iso ubuntu-20.04-amd64.json

An example to build Hyper-V and VMware would be:

$ packer build --only-hyperv-iso,vmware-iso ubuntu-20.04-amd64.json

To build homestead-arm for Apple Silicon:

$packer build --only=parallels-iso ubuntu-20.04-arm64.json

Once the build begins you will be able to view the GUI and see the initial boot process happen.

Initial boot Process

Testing the build

Once you have completed a build you can add the box to Vagrant via vagrant box add teststead ../../builds/ubuntu-20.04.parallels.box. Edit your Homestead.yaml Configuration to override the box name:

box: teststead
SpeakFriendAndEnter: true

Running vagrant destroy -f && vagrant up will create a new Homestead instance using the base box teststead.

Sharing the Build

This next step should only be completed when you want to share your base box with the world. Ensure you do not put any secrets in the base box. Once you have the .box file built you’re free to share it as needed. To share it on https://app.vagrantup.com you’ll want to create a hash of the box file via shasum -a 512 ../../builds/ubuntu-20.04.parallels.box

$ shasum -a 512 ../../builds/ubuntu-20.04.parallels.box
4a422d5f9cf86f18ea29bcf94441cf530d4e007c08f7d358d0b25d2c655886bca899b817c31e381c75899769c11ac369bd12a91a4c7994930a9966127470a08b  ../../builds/ubuntu-20.04.parallels.box

Create a Vagrant box and the next step is to create a new version:

Creating a new version

Next, we need to “Add a provider” and fill out the form for the box we’re planning on sharing.

Clicking “Continue to Upload” takes us to a form where we can Browse to our .box file and select it to upload the file.

uploading a vagrant box to the public

Once the upload completes the next step is to navigate back to your version and click the “Release” button to make your box public.

Happy base box building!

Sort:

Trending

[-]

eniolw (72) 3 years ago

Hi.

How can we verify you own that site and that content? I peeked in but couldn't find a backref to your blog on Hive. I only found this:

$0.68

5 votes

joepferguson (47) 3 years ago

I've previously been verified via https://hivewatchers.com/verifications?utf8=%E2%9C%93&verification%5Busername_search%5D=joepferguson

$0.00

stemsocial (63) 3 years ago

Thanks for your contribution to the STEMsocial community. Feel free to join us on discord to get to know the rest of us!

Please consider delegating to the @stemsocial account (85% of the curation rewards are returned).

You may also include @stemsocial as a beneficiary of the rewards of this post to get a stronger support.

hivebuzz (74) 3 years ago

Congratulations @joepferguson! You have completed the following achievement on the Hive blockchain and have been rewarded with new badge(s):

You got more than 10 replies.
Your next target is to reach 50 replies.

_{You can view your badges on your board and compare yourself to others in the Ranking}
_{If you no longer want to receive notifications, reply to this comment with the word STOP}

Check out the last post from @hivebuzz:

Hive Power Up Day - August 1st 2022