> ## Documentation Index
> Fetch the complete documentation index at: https://herd.laravel.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Sites

# Sites

Herd uses the concept of *parked* paths and *linked* directories for serving sites. You can access every site in a parked path via `http://<directory-name>.test`. By default, Herd will automatically park the `%USERPROFILE%\Herd` directory for you. Any PHP application in this directory is automatically available via its `.test` domain. If you have other locations for your projects, you can add them as parked paths in the general settings or link individual projects as a linked directory.

<Frame>
  <img alt="General Settings" src="https://mintcdn.com/herd/dMLnVLuqj_YG0ri0/images/docs/windows/settings_general.png?fit=max&auto=format&n=dMLnVLuqj_YG0ri0&q=85&s=0d17c3eb1a7a5a41e77638c4dc1ba1ef" width="2744" height="1994" data-path="images/docs/windows/settings_general.png" />
</Frame>

Aside from Laravel, Herd [supports many frameworks](/windows/extending-herd/supported-frameworks) and applications out-of-the-box. If your framework is not in the list, you can create a [custom driver](/windows/extending-herd/custom-drivers) to run it with Herd.

## Creating your first site

The fastest way to manage your sites and to create new applications is the command line.

#### Command Prompt (CMD)

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

#### Powershell

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

These commands go into your Herd directory, create a brand-new Laravel application and open it in your browser. The `herd edit` command even opens your favorite IDE if you've set up [the protocols](/windows/advanced-usage/managing-sites#open-in-ide).

## Linking an existing site

You can link an existing site with a specific domain via the `link` command from any directory on your machine. The `link` command uses the directory name as domain name if you don't set additional parameters.

#### Command Prompt (CMD)

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

#### Powershell

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

These commands create Herd configurations, add the domains to your hosts file, and you can now access the application via `your-project.test` and `custom-domain.test`. This is useful if you want to use an application from multiple domains, for example in multi-tenancy environments or if you store all your projects across multiple directories.

## Via the GUI

If you prefer creating and linking sites via a graphical user interface, you can use Herd's site wizard to create new Laravel applications or link existing projects.

You can start the site wizard by opening the [Site Manager](/windows/advanced-usage/managing-sites) from the Herd dashboard or the system tray icon.

## Unlinking an existing site

You may remove a previously created link, by using the `unlink` command from any directory on your machine. The `unlink` command uses the directory name as domain name if you don't set additional parameters.

#### Command Prompt (CMD)

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

#### Powershell

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

These commands remove any previous created links to your site.

<Frame>
  <img alt="Site Manager of Herd" src="https://mintcdn.com/herd/dMLnVLuqj_YG0ri0/images/docs/windows/sites.png?fit=max&auto=format&n=dMLnVLuqj_YG0ri0&q=85&s=3bd4bcb484d0b5a962232f3af6d09839" width="2744" height="1994" data-path="images/docs/windows/sites.png" />
</Frame>

After that, you can select the plus icon at the top left to create or link a new site.

<Frame>
  <img alt="Site Wizard to create new Laravel applications" src="https://mintcdn.com/herd/8sm4YnmqUuRPQUjM/images/docs/windows/sites_wizard.png?fit=max&auto=format&n=8sm4YnmqUuRPQUjM&q=85&s=d54ec6a1f91542a31ef6206f59ca4fd8" width="2744" height="1994" data-path="images/docs/windows/sites_wizard.png" />
</Frame>

### Database

<Note>
  Herd detects [Tinkerwell](https://tinkerwell.app/?ref=herd) and [TablePlus](https://tableplus.com/windows) on your machine and the buttons automatically open these tools instead of Laravel Tinker on the command line or Adminer for databases.
</Note>

SQLite databases have no credentials and the other databases use root as the username without a password. In most cases, you should be able to simply click the login button and work with the database.

## Open in IDE

You can quickly open the site in your IDE by clicking the "Open" button or by running the `herd edit` command in your CLI. You can set your default IDE in the Herd Settings under the "General" tab. Currently, PhpStorm, VS Code, and Sublime Text are supported.
Please note that site-wide opening is only available for PhpStorm and VS Code due to limitations with Sublime Text. However, you can still open individual files in Sublime Text, such as when clicking on a location in the Dumps window.

<Note>
  For PhpStorm, make sure to install the latest version of the [PhpStorm protocol handler](https://github.com/aik099/PhpStormProtocol). For Sublime Text, the [subl-protocol](https://github.com/thecotne/subl-protocol) is required.
</Note>

## Application Information

The "Information" tab gives you a brief overview of the application. Laravel apps display the content of the `php artisan about` command, but you can customize the overview by using a [custom driver](/windows/extending-herd/custom-drivers) for your site.

## Integrations

Herd allows linking your local site with first-party Laravel cloud services and makes triggering common tasks like deployments super easy. At the moment, Herd supports connecting to sites on Laravel Forge with the [Forge integration](/windows/integrations/laravel-forge).