Laravel Herd Windows

https://herd.laravel.com/docs/windows/
Admin
Laravel Herd is a blazing fast, native Laravel and PHP development environment for Windows,...
Tokens:28,090
Snippets:481
Trust Score:9.9
Update:3 months ago
Show doc for...
Tokens:
Raw
### Apply herd.yml Project Setup

Source: https://herd.laravel.com/docs/windows/sites/herd-yaml

Run `herd init` in a project with an existing `herd.yml` file to automatically apply configurations. This includes setting up the PHP version, securing the site, and starting specified services.

```bash
 ~ herd-website  (main)
› herd init

   INFO  Setting up your project…

   INFO  PHP 8.3 is installed.

   INFO  Site is secured.

   INFO  Mysql is running on port 3346

   INFO  Installing service Redis
   INFO  Redis is running on port 6379

   DONE  Your application is ready to go!
```

--------------------------------

### Start Service Instance

Source: https://herd.laravel.com/docs/windows/advanced-usage/command-line

Starts a specified service instance. This command is available for Herd Pro users.

```powershell
herd services:start mysql
```

--------------------------------

### List All Installed Services

Source: https://herd.laravel.com/docs/windows/herd-pro-services/services

Lists all installed services and their current status. Use this to get an overview of your running services.

```powershell
herd services:list
```

--------------------------------

### List Installed PHP Versions

Source: https://herd.laravel.com/docs/windows/advanced-usage/command-line

Display all available PHP versions and their installation status, including update availability.

```powershell
herd php:list

+---------+-----------+------------------+
| Version | Status    | Update Available |
+---------+-----------+------------------+
| 8.5     | Installed |                  |
| 8.4 *   | Installed |                  |
| 8.3     | Installed |                  |
| 8.2     | Installed |                  |
| 8.1     | Installed |                  |
| 8.0     | Installed |                  |
| 7.4     | Installed |                  |
+---------+-----------+------------------+
```

--------------------------------

### Install PHP Version

Source: https://herd.laravel.com/docs/windows/advanced-usage/command-line

Install a specific PHP version using the Herd command-line tool.

```powershell
herd php:install 8.3
```

--------------------------------

### Install, Uninstall, and Use Node.js Versions via CLI

Source: https://herd.laravel.com/docs/windows/technology/node-versions

Use these nvm commands to manage Node.js installations. Install a specific version, remove it, or switch to it for your current session. 'nvm use' without arguments switches to the directory-specific version.

```bash
# Install node 20
nvm install 20

# Uninstall node 20
nvm uninstall 20

# Switch to node 20
nvm use 20

# Switch to the isolated node version for the current directory
nvm use

## Display all commands
nvm help
```

--------------------------------

### Example herd.yml Configuration File

Source: https://herd.laravel.com/docs/windows/sites/herd-yaml

This `herd.yml` example demonstrates various customizations including project name, PHP version, TLS/SSL settings, aliases, and specific service versions and ports. Ports can be fixed or referenced from environment variables.

```yaml
name: herd-website
php: '8.3'
secured: true
alias:
    - herd-laravel
services:
    mysql:
        version: 8.0.36
        port: '${DB_PORT}'
    redis:
        version: 7.0.0
        port: '${REDIS_PORT}'
```

--------------------------------

### Install HerdHelper Service Manually

Source: https://herd.laravel.com/docs/windows/troubleshooting/herdhelper

Install the HerdHelper service from scratch using the 'sc.exe create' command. Ensure you replace 'YOUR_USERNAME' with your actual Windows username and escape any special characters in the path.

```powershell
sc.exe create HerdHelper binPath="C:\Users\YOUR_USERNAME\.config\herd\bin\HerdHelper.exe" start=auto
```

--------------------------------

### Interactive Project Initialization Wizard

Source: https://herd.laravel.com/docs/windows/sites/herd-yaml

This interactive wizard guides you through setting up your project's `herd.yml` file, including project name, aliases, PHP version, and service selections.

```bash
 ~ herd-website  (main)
› herd init --fresh

 ┌ What is the name of your project? ───────────────────────────┐
 │ herd-website                                                 │
 └──────────────────────────────────────────────────────────────┘

... 

 ┌ Do you want to add additional services? ─────────────────────┐
 │ › ◻ Meilisearch (1.6.2)                                    ┃ │
 │   ◻ MinIO (RELEASE.2024-03-05)                             │ │
 │   ◼ MySQL (8.0.36)                                         │ │
 │   ◻ PostgreSQL (16)                                        │ │
 │   ◼ Redis (7.0.0)                                          │ │
 └────────────────────────────────────────────────── 2 selected ┘
  Use the space bar to select options.
```

--------------------------------

### Start and Stop Services

Source: https://herd.laravel.com/docs/windows/herd-pro-services/services

Controls the running state of a service instance. Use 'start' to launch a service and 'stop' to halt it.

```powershell
herd services:start mysql
```

```powershell
herd services:stop mysql
```

--------------------------------

### Nginx Configuration Example

Source: https://herd.laravel.com/docs/windows/migration-guides/laragon

This is a standard Nginx configuration for routing requests to your PHP application, typically used in web server setups.

```nginx
location / {
    try_files $uri $uri/ /public/index.php?$query_string;
}
```

--------------------------------

### Example Herd Generated Hosts File Entries

Source: https://herd.laravel.com/docs/windows/troubleshooting/common-issues

This is an example of how Herd Helper should format entries in the Windows hosts file. These entries redirect specified domains to your local machine.

```bash
# Herd generated Hosts. Do not change.
127.0.0.1 database.herd.test
127.0.0.1 your-site.test
# End Herd generated Hosts
```

--------------------------------

### Start HerdHelper Service

Source: https://herd.laravel.com/docs/windows/troubleshooting/herdhelper

If the HerdHelper service is installed but stopped, you can start it using this command in an elevated PowerShell or Command Prompt.

```powershell
sc.exe start HerdHelper
```

--------------------------------

### Manually Start HerdHelper

Source: https://herd.laravel.com/docs/windows/troubleshooting/herdhelper

If the HerdHelper service does not start automatically, you can try starting it manually from its executable path. This will open a terminal window with logs to aid in debugging.

```powershell
%USERPROFILE%\.config\herd\bin\HerdHelper.exe
```

--------------------------------

### List Available PHP Versions via CLI

Source: https://herd.laravel.com/docs/windows/technology/php-versions

View all available PHP versions and their installation status using the `herd php:list` command.

```powershell
herd php:list
```

--------------------------------

### Install Meilisearch PHP SDK

Source: https://herd.laravel.com/docs/windows/herd-pro-services/meilisearch

Install the necessary Meilisearch PHP SDK and a PSR-17 compatible HTTP factory implementation using Composer. This is required for the Meilisearch driver in Laravel Scout.

```bash
composer require meilisearch/meilisearch-php http-interop/http-factory-guzzle
```

--------------------------------

### Check HerdHelper Service Installation Status

Source: https://herd.laravel.com/docs/windows/troubleshooting/herdhelper

Verify if the HerdHelper service is installed on your Windows system. This command can be run from an elevated PowerShell or Command Prompt.

```powershell
sc.exe query HerdHelper
```

--------------------------------

### List Available Service Types

Source: https://herd.laravel.com/docs/windows/herd-pro-services/services

Shows all the types of services that Herd Pro can install. This helps in identifying which services are supported.

```powershell
herd services:available
```

--------------------------------

### Verify Herd and Tool Versions

Source: https://herd.laravel.com/docs/windows/getting-started/installation

After installation, verify that Herd and its associated tools (PHP, Laravel, Composer, Node.js) are correctly installed and accessible from your terminal by checking their versions.

```shell
herd --version
php --version
laravel --version
composer --version
node --version
```

--------------------------------

### Herd Application Directory

Source: https://herd.laravel.com/docs/windows/advanced-usage/directories-and-files

This is the main installation directory for the Herd application.

```bash
C:\Program Files\herd
```

--------------------------------

### Standard MCP Server Configuration

Source: https://herd.laravel.com/docs/windows/advanced-usage/ai-integrations

This JSON configuration is used for most MCP clients. Replace 'YOUR-SITE-PATH' with your project's base path or remove the 'env' key for global installations. Ensure environment variables like %USERPROFILE% are correctly resolved.

```json
{
    "herd": {
        "command": "php",
        "args": [
            "%USERPROFILE%/.config/herd/bin/herd-mcp.phar"
        ],
        "env": {
            "SITE_PATH": "YOUR-SITE-PATH"
        }
    }
}
```

--------------------------------

### Herd Updater Files Directory

Source: https://herd.laravel.com/docs/windows/advanced-usage/directories-and-files

Downloaded updates are stored here. If update installation fails, try deleting these files and re-downloading.

```bash
%USERPROFILE%\AppData\Local\herd-updater
```

--------------------------------

### Enable Xdebug Extension in php.ini

Source: https://herd.laravel.com/docs/windows/debugging/xdebug

Append these lines to your php.ini file to enable Xdebug for PHP 8.3. Ensure the zend_extension path is correct for your Herd installation.

```bash
zend_extension=C:\ Program Files\ Herd\ resources\ app.asar.unpacked\ resources\ bin\ xdebug\ xdebug-8.3.dll
xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.start_upon_error=yes
```

--------------------------------

### Initialize Project with Herd

Source: https://herd.laravel.com/docs/windows/migration-guides/sail

Run this command to configure your project according to the herd.yml file and set up services.

```bash
herd init
```

--------------------------------

### Create and Open a New Laravel Project (CMD)

Source: https://herd.laravel.com/docs/windows/getting-started/sites

Navigate to your Herd directory, create a new Laravel project, and open it in your browser and IDE using CMD.

```bash
cd %USERPROFILE%\Herd
laravel new my-project
cd my-project
herd open
herd edit
```

--------------------------------

### Link Existing Site via CMD

Source: https://herd.laravel.com/docs/windows/getting-started/sites

Use the `herd link` command in the Command Prompt to link the current directory as a site. You can also specify a custom domain name.

```bash
cd %USERPROFILE%\Herd\your-project
herd link
```

```bash
cd %USERPROFILE%\Herd\your-project
herd link custom-domain
```

--------------------------------

### Share a Local Site via Expose

Source: https://herd.laravel.com/docs/windows/sites/sharing-sites

Navigate to your site's directory and run the `herd share` command to share it. You can share a linked site by providing its URL.

```shell
cd %USERPROFILE%/Herd/example-site

herd share

# Share a linked site:
herd share http://your-local-site.test

# You can share a secured site with:
herd share https://your-secure-local-site.test
```

--------------------------------

### Connect to MySQL via CLI

Source: https://herd.laravel.com/docs/windows/herd-pro-services/mysql

Connect to the running MySQL server using the command line client. This command assumes the MySQL binary has been added to your PATH and uses default Herd Pro credentials and port.

```bash
mysql -u root -h 127.0.0.1 -P 3306 -p
```

--------------------------------

### Create and Open a New Laravel Project (PowerShell)

Source: https://herd.laravel.com/docs/windows/getting-started/sites

Navigate to your Herd directory, create a new Laravel project, and open it in your browser and IDE using PowerShell.

```powershell
Set-Location -Path "$env:USERPROFILE\Herd"
laravel new my-project
cd my-project
herd open
herd edit
```

--------------------------------

### Update PHP Version

Source: https://herd.laravel.com/docs/windows/advanced-usage/command-line

Update an installed PHP version to its latest patch release.

```powershell
herd php:update 8.4
```

--------------------------------

### Add MongoDB Laravel Package Dependency

Source: https://herd.laravel.com/docs/windows/herd-pro-services/mongodb

Install the mongodb/laravel-mongodb composer package to integrate MongoDB with your Laravel application.

```bash
composer require mongodb/laravel-mongodb
```

--------------------------------

### Connect to MariaDB via CLI

Source: https://herd.laravel.com/docs/windows/herd-pro-services/mariadb

Connect to the running MariaDB server using the command-line client. This command assumes the MariaDB binary has been added to your PATH.

```bash
mariadb -u root -h 127.0.0.1 -P 3306 -p
```

--------------------------------

### Secure a Site via CLI

Source: https://herd.laravel.com/docs/windows/sites/securing-sites

Use this command to enable TLS/HTTPS for a specific site managed by Herd. Replace 'example-site' with your actual site name.

```shell
herd secure example-site
```

--------------------------------

### Create a New Service Instance

Source: https://herd.laravel.com/docs/windows/herd-pro-services/services

Creates a new instance of a specified service type, such as MySQL. This command provisions the service with default configurations.

```powershell
herd services:create mysql
```

--------------------------------

### Connect to PostgreSQL via CLI

Source: https://herd.laravel.com/docs/windows/herd-pro-services/postgresql

Once the PostgreSQL binaries are in your PATH, you can use this command to connect to the running PostgreSQL server from your terminal.

```bash
psql -U postgres -h 127.0.0.1 -p 5432
```

--------------------------------

### List Available Versions for a Service Type

Source: https://herd.laravel.com/docs/windows/herd-pro-services/services

Displays the specific versions available for a given service type, like MySQL. Useful for selecting a version before creation.

```powershell
herd services:versions mysql
```

--------------------------------

### MinIO Client (mc) Common Commands

Source: https://herd.laravel.com/docs/windows/herd-pro-services/minio

A collection of common MinIO Client commands for managing buckets and files. Use these after setting up an alias for your MinIO service.

```bash
mc mb herd/my-bucket
mc ls herd
mc ls herd/my-bucket
mc cp file.txt herd/my-bucket/
```

--------------------------------

### Manage Herd Loopback Address

Source: https://herd.laravel.com/docs/windows/advanced-usage/command-line

Use `herd loopback` to get the current loopback address. Use `herd loopback <address>` to set a new loopback address.

```powershell
herd loopback
herd loopback 127.0.0.1
```

--------------------------------

### Update Mail Settings for Herd

Source: https://herd.laravel.com/docs/windows/migration-guides/laragon

Configure your application's .env file to use Herd's mail testing service. This example shows the basic SMTP settings required.

```env
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=${APP_NAME}
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
```

--------------------------------

### Add MariaDB Binary to PATH (CMD)

Source: https://herd.laravel.com/docs/windows/herd-pro-services/mariadb

Add the MariaDB binary directory to your system's PATH environment variable using Command Prompt (CMD). This enables command-line access to MariaDB. Restart your terminal session for the changes to apply.

```bash
setx PATH "%PATH%;%USERPROFILE%\.config\herd\bin\services\mariadb\8.0.36\bin"
```

--------------------------------

### Uninstall a Specific Node.js Version via CLI

Source: https://herd.laravel.com/docs/windows/technology/node-versions

To remove a specific Node.js version, use the 'nvm uninstall' command followed by the version number. You can list installed versions with 'nvm list'.

```bash
nvm uninstall VERSION
```

--------------------------------

### Park a Directory with Herd

Source: https://herd.laravel.com/docs/windows/advanced-usage/command-line

Park a directory to make all its subdirectories available as .test sites. You can park the current directory or a specified path.

```powershell
herd park
herd park C:\Users\you\Code
```

--------------------------------

### Configure Laravel Mail Settings

Source: https://herd.laravel.com/docs/windows/herd-pro-services/mail

Add these settings to your local .env file to direct mail to the Herd Pro mail UI. Ensure MAIL_HOST and MAIL_PORT are correctly set for your Herd installation.

```bash
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=${APP_NAME}
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"
```

--------------------------------

### Import Database using MySQL Command Line

Source: https://herd.laravel.com/docs/windows/migration-guides/xampp

Import your exported SQL database file into the new MySQL service set up with Herd. Ensure the database service is running and accessible.

```sql
mysql -u root -h 127.0.0.1 -P 3306 your_database < your_database.sql
```

--------------------------------

### Share Site with Basic Authentication

Source: https://herd.laravel.com/docs/windows/sites/sharing-sites

Protect your shared site links with basic authentication by adding the `--basicAuth` argument and providing credentials.

```shell
herd share https://example-site.test --basicAuth="user:password"
```

--------------------------------

### Import Database into Herd's MySQL

Source: https://herd.laravel.com/docs/windows/migration-guides/sail

Import a SQL database backup into Herd's MySQL instance.

```bash
mysql -u root -P 3306 -h 127.0.0.1 your_database_name < database_backup.sql
```

--------------------------------

### Open PHP Configuration File

Source: https://herd.laravel.com/docs/windows/advanced-usage/command-line

Open the php.ini file for the current global or isolated PHP version in your IDE.

```powershell
herd ini
herd ini 8.0
```

--------------------------------

### Link Existing Site via PowerShell

Source: https://herd.laravel.com/docs/windows/getting-started/sites

Use the `herd link` command in PowerShell to link the current directory as a site. You can also specify a custom domain name.

```powershell
Set-Location -Path "$env:USERPROFILE\Herd\your-project"
herd link
```

```powershell
Set-Location -Path "$env:USERPROFILE\Herd\your-project"
herd link custom-domain
```

--------------------------------

### Interactive Site Selection Prompt

Source: https://herd.laravel.com/docs/windows/integrations/laravel-forge

When the CLI detects multiple linked sites, it prompts you to select which site to use for the command. This ensures the correct site is targeted.

```bash
 ┌ Select the Forge integration to use: ────────────────────────┐
 │ › ● herd.laravel.com                                         │
 │   ○ latest.herdphp.com                                       │
 └──────────────────────────────────────────────────────────────┘
```

--------------------------------

### Link a Site with Herd

Source: https://herd.laravel.com/docs/windows/advanced-usage/command-line

Register a site outside of a parked path. Supports linking multiple domains to a single application.

```powershell
# Link the current directory as some-site.test
herd link some-site
# Link the same application via some-other-domain.test
herd link some-other-domain
```

--------------------------------

### Add MySQL Binary to PATH (Command Prompt)

Source: https://herd.laravel.com/docs/windows/herd-pro-services/mysql

Add the MySQL binary directory to your system's PATH environment variable using the Command Prompt. This enables running MySQL commands from any terminal session. Restart your terminal after execution.

```bash
setx PATH "%PATH%;%USERPROFILE%\.config\herd\bin\services\mysql\8.0.36\bin"
```

--------------------------------

### Set Up MinIO Client Alias

Source: https://herd.laravel.com/docs/windows/herd-pro-services/minio

Configure the MinIO Client (mc) to alias your Herd MinIO service. This allows you to manage buckets and objects using the mc command-line tool.

```bash
mc alias set herd http://localhost:9000 herd secretkey
```

--------------------------------

### Define Project Configuration in herd.yml

Source: https://herd.laravel.com/docs/windows/migration-guides/sail

Create a herd.yml file to specify project-specific configurations like PHP version and services.

```yaml
name: your-project-name
php: '8.3'
services:
    mysql:
        version: 8.0.36
        port: '${DB_PORT}'
    redis:
        version: 7.0.0
        port: '${REDIS_PORT}'
```

--------------------------------

### Add PostgreSQL Binaries to PATH (Command Prompt)

Source: https://herd.laravel.com/docs/windows/herd-pro-services/postgresql

This command adds the PostgreSQL binary directory to your system's PATH environment variable using the Command Prompt. Restart your terminal session for the changes to take effect.

```bash
setx PATH "%PATH%;%USERPROFILE%\.config\herd\bin\services\postgresql\16\bin"
```

--------------------------------

### Enable OPcache JIT for CLI Performance

Source: https://herd.laravel.com/docs/windows/technology/php-settings

Configure your php.ini file to enable the OPcache JIT compiler for significant performance improvements in CLI-heavy workloads. Herd enables opcache.enable_cli=1 by default.

```ini
opcache.jit_buffer_size=256M
opcache.jit=1255
```

--------------------------------

### Configure Laravel Application for Reverb

Source: https://herd.laravel.com/docs/windows/herd-pro-services/laravel-reverb

Set these environment variables in your Laravel application to connect to the Reverb server. Ensure the APP_ID, APP_KEY, and APP_SECRET match your Reverb configuration.

```bash
REVERB_APP_ID=1001
REVERB_APP_KEY=laravel-herd
REVERB_APP_SECRET=secret
REVERB_HOST="0.0.0.0"
REVERB_PORT=8080
```

--------------------------------

### Check Port Usage with netstat

Source: https://herd.laravel.com/docs/windows/troubleshooting/nginx

Use these commands to identify which processes are listening on ports 80 and 443. This helps diagnose Nginx startup failures due to port conflicts.

```powershell
netstat -aon | findstr :80
netstat -aon | findstr :443
```

--------------------------------

### List All Secured Sites via CLI

Source: https://herd.laravel.com/docs/windows/sites/securing-sites

This command lists all sites that currently have a local TLS certificate generated by Herd. Useful for debugging and verification.

```shell
herd secured
```

--------------------------------

### Share Sites via ngrok

Source: https://herd.laravel.com/docs/windows/sites/sharing-sites

Use ngrok to share Herd sites by forwarding HTTP traffic. Specify the host header to rewrite for proper routing.

```shell
ngrok http --host-header=rewrite unsecured-site.test
ngrok http --host-header=rewrite secured-site.test:443
```

--------------------------------

### Display Configured Proxies

Source: https://herd.laravel.com/docs/windows/advanced-usage/command-line

This command displays all configured proxy sites within Herd.

```powershell
herd proxies
```

--------------------------------

### Export Database from Sail

Source: https://herd.laravel.com/docs/windows/migration-guides/sail

Use Sail to export your database to a SQL file for migration.

```bash
./vendor/bin/sail mysqldump your_database > database_backup.sql
```

--------------------------------

### Copy Site Files from XAMPP to Herd

Source: https://herd.laravel.com/docs/windows/migration-guides/xampp

Use the xcopy command to move your site files from the XAMPP htdocs directory to the Herd directory. Ensure the target directory exists.

```powershell
# Create directories if they don't exist
mkdir %USERPROFILE%\Herd

# Copy your sites
xcopy C:\xampp\htdocs\your-site %USERPROFILE%\Herd\your-site\ /E /H /C /I
```

--------------------------------

### Revert Site to Global PHP Version via CLI

Source: https://herd.laravel.com/docs/windows/technology/php-versions

Remove per-site PHP version isolation and revert to the global PHP version by running `herd unisolate` from the site's root directory.

```powershell
herd unisolate
```

--------------------------------

### Unsecure a Site via CLI

Source: https://herd.laravel.com/docs/windows/sites/securing-sites

Use this command to disable TLS/HTTPS for a specific site, reverting it to plain HTTP. Replace 'example-site' with your actual site name.

```shell
herd unsecure example-site
```

--------------------------------

### Add MariaDB Binary to PATH (Powershell)

Source: https://herd.laravel.com/docs/windows/herd-pro-services/mariadb

Add the MariaDB binary directory to your system's PATH environment variable using Powershell. This allows you to run MariaDB commands from any terminal. Restart your terminal session for changes to take effect.

```powershell
setx PATH "$env:PATH;$env:USERPROFILE\.config\herd\bin\services\mariadb\10.11\bin"
```

--------------------------------

### List of Laravel Forge CLI Commands

Source: https://herd.laravel.com/docs/windows/integrations/laravel-forge

This section lists all available commands for interacting with Laravel Forge via the CLI. These commands cover a wide range of management tasks for your sites and servers.

```bash
command          Execute a CLI command
deploy           Deploy a site
open             Open a site in forge.laravel.com
ssh              Start an SSH session
tinker           Tinker with a site

daemon:list      List the daemons
daemon:logs      Retrieve the latest daemon log messages
daemon:restart   Restart a daemon
daemon:status    Get the current status of a daemon

database:logs    Retrieve the latest database log messages
database:restart Restart the database
database:shell   Start a database shell
database:status  Get the current status of the database

deploy:logs      Retrieve the latest deployment log messages

env:pull         Download the environment file for the given site
env:push         Upload the environment file for the given site

nginx:logs       Retrieve the latest Nginx log messages
nginx:restart    Restart Nginx
nginx:status     Get the current status of Nginx

php:logs         Retrieve the latest PHP log messages
php:restart      Restart PHP
php:status       Get the current status of PHP

server:current   [current] Determine your current server
server:list      List the servers
server:switch    [switch] Switch to a different server

site:list        List the sites
site:logs        Retrieve the latest site log messages

ssh:configure    Configure SSH key based secure authentication
ssh:test         Test the SSH key based secure authentication connection
```

--------------------------------

### Update Database Credentials for Herd Pro MySQL

Source: https://herd.laravel.com/docs/windows/migration-guides/laragon

Configure your project's .env file to connect to the Herd Pro MySQL instance. Note the default port for Herd Pro MySQL.

```env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3307 # Default Herd Pro MySQL port
DB_DATABASE=your_database
DB_USERNAME=root
DB_PASSWORD=
```

--------------------------------

### Herd Configuration Directory

Source: https://herd.laravel.com/docs/windows/advanced-usage/directories-and-files

All configuration files for Herd services are stored here.

```bash
%USERPROFILE%\.config\herd\config
```

--------------------------------

### List Isolated Sites via CLI

Source: https://herd.laravel.com/docs/windows/technology/php-versions

Display a list of all sites configured with specific PHP versions using the `herd isolated` command.

```powershell
herd isolated
```

--------------------------------

### Secure a Site with Herd

Source: https://herd.laravel.com/docs/windows/migration-guides/laragon

Run this command in your project's directory to enable HTTPS for a specific site using Herd's secure sites feature. Ensure you have navigated to the correct project folder first.

```bash
cd %USERPROFILE%\Herd\your-project
herd secure
```

--------------------------------

### Share Site with Subdomain and Server Region

Source: https://herd.laravel.com/docs/windows/sites/sharing-sites

Customize your shared site by specifying a subdomain and server region using parameters with the `herd share` command.

```shell
herd share https://example-site.test --subdomain=my-project-name --server=us-1
```

--------------------------------

### Inspect Windows Hosts File

Source: https://herd.laravel.com/docs/windows/troubleshooting/common-issues

The Windows hosts file is regularly updated by HerdHelper to manage local DNS resolution. Examine this file to ensure Herd-generated entries are present.

```bash
C:\Windows\System32\drivers\etc\hosts
```

--------------------------------

### Run CLI Commands with Xdebug Enabled

Source: https://herd.laravel.com/docs/windows/debugging/xdebug-detection

Use `herd debug` instead of `php` to run CLI commands with Xdebug enabled. This is useful for debugging artisan commands.

```bash
herd debug artisan your:command
```

--------------------------------

### Valet Site-Specific Nginx Configuration

Source: https://herd.laravel.com/docs/windows/advanced-usage/directories-and-files

Directory for site-specific Nginx configuration files used by Valet.

```bash
%USERPROFILE%\.config\herd\config\valet\Nginx
```

--------------------------------

### Configure Meilisearch Environment Variables

Source: https://herd.laravel.com/docs/windows/herd-pro-services/meilisearch

Add these environment variables to your .env file to connect Laravel Scout to your Meilisearch instance. Ensure the port and key match your Meilisearch configuration.

```env
SCOUT_DRIVER=meilisearch
MEILISEARCH_HOST=http://127.0.0.1:7700
MEILISEARCH_KEY=LARAVEL-HERD
```

--------------------------------

### Herd Binaries Directory

Source: https://herd.laravel.com/docs/windows/advanced-usage/directories-and-files

Location for all Herd binaries, including bundled tools like composer and expose, as well as downloaded PHP versions.

```bash
%USERPROFILE%\.config\herd\bin
```
Tokens:
Raw