> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.ggcircuit.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Troubleshooting ggRock Client Agent Not Starting at Boot

# 🛠️ Troubleshooting: ggRock Client Agent Not Starting at Boot

In some cases, especially during trial installations or new deployments, a client machine may fail to appear under the **Hardware** tab in the ggRock UI. This is often caused by the **ggRock Client Agent not launching at system boot** due to a missing registry entry under `HKEY_CURRENT_USER`.
This article walks you through how to identify and resolve this issue quickly.

## ❓ Symptoms
* Machines do not appear in the ggRock **Hardware** page.

![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_1qna9wv.png)
* ggRock Client Agent process is not running in Task Manager after boot.
* Link Speed not visible in the ggRock Web UI

![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_h04y84.png)
## 🔍 Root Cause
The ggRock Client Agent is triggered by a `Run` key under `HKEY_CURRENT_USER`. 
If the registry entry is missing (due to improper user login context, permissions, or registry corruption), the agent will not start automatically.
## 🧰 Solution
### Step 1: Confirm the Agent Isn’t Running
1. Boot the client machine normally.
2. Open **Task Manager** and check for `GgRock.Client.exe` under the **Details** tab.
3. If it’s not listed, continue to the next step.
### Step 2: Manually Re-add the Registry Entry
1. Open **Notepad** and paste the following:Save the file as: `ggrock-client-agent.reg`

```
Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Run]
"ggRock Client Agent"="conhost \"%PROGRAMDATA%\ggRock\Client\GgRock.Client.exe\" -agent
```

1. Double-click the `.reg` file to import it into the registry.
✅ **Note:** This is safe to run even if the entry already exists — it will simply overwrite it.
### Step 3: Save Snapshot & Reboot
1. From the ggRock control panel, **save a snapshot** for the affected client.
2. **Reboot the client**.
3. After rebooting, verify the client appears under the **Hardware** page and is reporting link speed.
![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image_12x8jyg.png)

## 🧩 Additional Notes
* Make sure the PC is set to the correct **timezone** if login tokens are failing.
* Ensure link speed shows up for each client in the ggRock web UI as a sign of good connectivity.

If you continue having issues, please reach out to [ggCircuit Support](mailto:support@ggcircuit.com) with screenshots and relevant logs.
Happy booting! 🎉