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

# HerdHelper

## The HerdHelper Windows Service isn't working

There are many reasons why Herd can't write to your hosts file, sometimes it's locked by anti virus software or is simply read-only. The HerdHelper tries to mitigate these situations automatically but can also write logs to track down the issue, so if the helper works and the status is green, please check these logs.

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

If the helper doesn't start, please try starting it by changing the port or via your Windows Services or even by starting it manually at the following path:

```ps1 theme={null}
%USERPROFILE%\.config\herd\bin\HerdHelper.exe
```

Starting it manually reveals a terminal window with logs and should help debugging the issue.

## The HerdHelper service is not installed

If the HerdHelper service is not installed, you can either install it by running the Herd installer again or by installing it manually. At first, you can double-check if the service is installed by running the following command via an elevated PowerShell or Command Prompt:

```ps1 theme={null}
sc.exe query HerdHelper
```

> In some cases, `sc.exe` might not be in your PATH. In that case, you can find it in `C:\Windows\System32\sc.exe`. This also leads to the problem that Herd cannot detect the running HerdHelper while it actually works as expected. Please add the path `C:\Windows\system32` to your PATH variable to mitigate this issue.

If the service is simply stopped, you can start it with the following command:

```ps1 theme={null}
sc.exe start HerdHelper
```

In case, that you need to install it from scratch, you can do so by running the following command (please make sure to add your user directory there and escape any spaces or special characters):

```ps1 theme={null}
sc.exe create HerdHelper binPath="C:\Users\YOUR_USERNAME\.config\herd\bin\HerdHelper.exe" start=auto
```

After that, you can start the service with the following command:

```ps1 theme={null}
sc.exe start HerdHelper
```