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

# 🛠️ Solución de problemas: ggRock Client Agent no inicia en el arranque

En algunos casos, especialmente durante instalaciones de prueba o nuevas implementaciones, una máquina cliente puede no aparecer en la pestaña **Hardware** en la interfaz de ggRock. Esto a menudo se debe a que el **ggRock Client Agent no se inicia en el arranque del sistema** debido a una entrada de registro faltante en `HKEY_CURRENT_USER`.

Este artículo te guía sobre cómo identificar y resolver este problema rápidamente.

---

## ❓ Síntomas

* Las máquinas no aparecen en la página **Hardware** de ggRock.

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

* El proceso ggRock Client Agent no se ejecuta en el Administrador de tareas después del arranque.
* La velocidad de enlace no es visible en la interfaz web de ggRock

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

---

## 🔍 Causa raíz

El ggRock Client Agent se activa mediante una clave `Run` en `HKEY_CURRENT_USER`. Si falta la entrada de registro (debido a un contexto de inicio de sesión de usuario incorrecto, permisos o corrupción del registro), el agente no se iniciará automáticamente.

---

## 🧰 Solución

### Paso 1: Confirma que el agente no se está ejecutando

1. Reinicia la máquina cliente normalmente.
2. Abre el **Administrador de tareas** y busca `GgRock.Client.exe` en la pestaña **Detalles**.
3. Si no está listado, continúa al siguiente paso.

---

### Paso 2: Re-agregar manualmente la entrada de registro

1. Abre el **Bloc de notas** y pega lo siguiente:

```
   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. Guarda el archivo como: `ggrock-client-agent.reg`
3. Haz doble clic en el archivo `.reg` para importarlo al registro.

   ✅ **Nota:** Es seguro ejecutar esto incluso si la entrada ya existe — simplemente la sobrescribirá.

---

### Paso 3: Guarda una instantánea y reinicia

1. Desde el panel de control de ggRock, **guarda una instantánea** para el cliente afectado.
2. **Reinicia el cliente**.
3. Después de reiniciar, verifica que el cliente aparezca en la página **Hardware** y esté reportando la velocidad de enlace.

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

---

## 🧩 Notas adicionales

* Asegúrate de que la PC esté configurada en la zona horaria correcta si los tokens de inicio de sesión están fallando.
* Asegúrate de que la velocidad de enlace aparezca para cada cliente en la interfaz web de ggRock como señal de buena conectividad.

---

Si continúas teniendo problemas, comunícate con [ggCircuit Support](mailto:support@ggcircuit.com) con capturas de pantalla y registros relevantes.

¡Feliz arranque! 🎉