Install Valet Hub

Everything you need to get Valet Hub running on your Mac.

Requirements

• macOS 13 (Ventura) or later
• Apple Silicon or Intel
• Homebrew
• Laravel Valet

If you already have Homebrew and Valet installed, you can skip ahead to the download section.

Install Homebrew

Homebrew is the package manager that Valet uses under the hood to manage PHP, Nginx, MySQL, and other services. If you don't have it yet, open Terminal and run:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

The script walks you through the installation — it may ask for your password and prompt you to confirm the Xcode Command Line Tools installation. Let both proceed; they're required for Homebrew to work.

Once it finishes, verify everything is ready:

brew --version

If you see a version number, Homebrew is ready.

Apple Silicon Macs

If you're on an Apple Silicon Mac (M1, M2, M3, M4), Homebrew installs to /opt/homebrew. Make sure /opt/homebrew/bin is in your PATH. The installer usually does this automatically, but if commands like brew aren't found after installation, run:

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Install Laravel Valet

With Homebrew ready, install Valet:

composer global require laravel/valet
valet install

This sets up Nginx, PHP, and dnsmasq — everything Valet needs to serve your sites locally on *.test domains. When it finishes, try running:

valet --version

If you see a version number, Valet is installed and running.

PHP Requirement

Valet requires PHP to be installed via Homebrew. If you don't have PHP yet, install it first:

brew install php@8.3
brew link --overwrite php@8.3

Afterward, run valet install again to link everything together.

Download Valet Hub

1. Go to the releases page.
2. Download the .dmg file for your Mac's architecture (Apple Silicon or Intel).
3. Open the .dmg and drag Valet Hub to your Applications folder.

First Launch

1. Open Valet Hub from your Applications folder.
2. If macOS shows a security warning, go to System Settings > Privacy & Security and click Open Anyway.
3. Run this command in your terminal to grant Valet the permissions it needs:

valet trust

Valet Hub will now detect your Valet setup and show your sites and services.

Updating

Download the latest release from the releases page and replace your existing copy in Applications. Your configuration stays intact — no migration needed.

Troubleshooting

"Valet Hub" cannot be opened

macOS might block the app because it's not signed with an Apple Developer account. Go to System Settings > Privacy & Security and click Open Anyway under the security section.

Sites or services not showing

Make sure Valet is installed and has sites registered:

valet --version
valet links
valet paths

If valet links shows your sites in the terminal, they'll appear in Valet Hub.

Services not starting

Valet Hub controls services through Homebrew. Check that your services are managed properly:

brew services list

If a service is stopped or shows an error, you can start it from the Services page in Valet Hub.