### 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
` 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 ``` -------------------------------- ### 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 ``` -------------------------------- ### 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 ``` -------------------------------- ### 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 ```