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

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://ggcircuit.atlassian.net/wiki/download/attachments/15862337/image-20250424-212348.png?version=1&modificationDate=1745529837825&cacheVersion=1&api=v2)

* ggRock Client Agent process is not running in Task Manager after boot.
* Link Speed not visible in the ggRock Web UI

  ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15862337/image-20250424-212638.png?version=1&modificationDate=1745530005404&cacheVersion=1&api=v2)

---

## 🔍 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:

```
   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"
```
2. Save the file as: `ggrock-client-agent.reg`
3. 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://ggcircuit.atlassian.net/wiki/download/attachments/15862337/image-20250424-212500.png?version=1&modificationDate=1745529909214&cacheVersion=1&api=v2)

---

## 🧩 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! 🎉

---