Getting Started

Before you begin

You'll need Laravel Valet installed on your Mac. If you haven't set it up yet, head to the Laravel Valet documentation and follow the installation guide — it only takes a few minutes.

First launch

When you open Valet Hub for the first time, it detects your existing Valet setup automatically. Your linked and parked sites appear in the Sites page, and the Dashboard shows your PHP version, Valet version, and service status at a glance.

What to do first

Add a site

Go to the Sites page. If you have a project folder that Valet isn't serving yet, click Link and select the folder. Valet Hub registers it with Valet, and the site appears in your list immediately.

If you keep all your projects in a dedicated folder (like ~/Code or ~/Sites), click Park instead. Valet will serve every project inside that directory automatically.

Secure a site

Need HTTPS for local development? Click the Actions menu on any site and choose Secure. Valet enables TLS with a locally-trusted certificate — no browser warnings.

Pin a PHP version

Different projects need different PHP versions. Open the Actions menu, choose Isolate PHP, and pick the version you need. Valet switches to it just for that site while the rest of your environment stays on the global default.

Managing services

The Services page shows everything Valet manages — Nginx, PHP, MySQL, Redis, and more. Start, stop, or restart any service with one click. If something isn't working right, click a service card to see its logs, configuration paths, and resource usage.

Configuration

Open Settings from the sidebar. From there you can:

• Switch the global PHP version Valet uses.
• Change your Valet domain suffix (.test, .localhost, etc.).
• Toggle dark mode.
• Control whether Valet Hub launches when you log in.
• Update Valet itself when a new version is available.