#

Requirements

Herd requires macOS 12.0 or higher.

#

Installation

You can download the latest version of Herd from the website.

After downloading the DMG file, double-click the file to open it, and drag the Herd icon to the Applications folder. Once Herd is installed, open it from your Applications folder.

After the installation process is complete, you will have a fully-functioning PHP and Laravel development environment. This means you may easily invoke the php, laravel, and composer binaries from your terminal:

php --version
laravel --version
composer --version
node --version

Herd does not alter any services on your system, and if it's not for you, you can easily switch back to your previous setup.

#

Migrate from Valet

Herd makes it easy to migrate all of your existing Valet sites, certificates and settings to Herd. Upon opening Herd for the first time, Herd will automatically detect your existing Valet installation and migrate all of your sites, certificates and settings to Herd.

If Valet is still running, Herd will ask you to stop Valet before continuing with the installation.

It is important to note that Herd will not modify your existing Valet installation in any way. This means that you can easily switch back to Valet at any time. Just quit Herd and run valet start to start Valet again.

#

Using Herd with Fish

If you are using the Fish shell, you will need to run the following command to add the Herd binaries to your path:

fish_add_path -U $HOME/Library/Application\ Support/Herd/bin/