Instalar en Windows
Docker Desktop ejecuta el agente de la misma forma que Linux. Nunca tocas WSL directamente — Docker Desktop instala y gestiona su propio backend de WSL2, y el agente corre dentro de él.
1. Instala las piezas
- Driver de NVIDIA — el driver normal de Windows desde nvidia.com/drivers, versión 575 o más nueva. No hay un driver aparte para WSL; el de Windows ya lo cubre.
- Docker Desktop con el backend de WSL2 (el que viene por defecto). Deja que termine su configuración inicial.
Luego comprueba ambos en PowerShell:
docker run hello-world
docker run --rm --gpus all nvidia/cuda:12.4.1-base-ubuntu22.04 nvidia-smi
El segundo debe imprimir tu tarjeta. Si no lo hace, el driver es demasiado viejo o Docker Desktop no está en el backend de WSL2.
2. Elige una contraseña y guárdala
Windows no tiene openssl, así que la tomamos prestada de un contenedor —
esto funciona en cualquier máquina que pueda correr Docker.
$pw = docker run --rm alpine sh -c "head -c 32 /dev/urandom | base64 -w0"
echo $pw # anótala ahora mismo
3. Ejecútalo
Nota la comilla invertida ` para continuar líneas — el equivalente en
PowerShell de \.
docker run -d --name neurogrid-agent `
--gpus all --restart unless-stopped `
--log-driver json-file `
--log-opt max-size=10m `
--log-opt max-file=3 `
--dns 1.1.1.1 --dns 8.8.8.8 `
-v neurogrid-data:/data `
-v /var/run/docker.sock:/var/run/docker.sock `
-v /var/lib/neurogrid/workloads:/var/lib/neurogrid/workloads `
-e AGENT_ENCRYPTION_PASSWORD="$pw" `
ghcr.io/neurogrid-ai-exchange/neurogrid-agent:latest --token ng_live_xxxxxxxx
Luego mira cómo se registra:
docker logs -f neurogrid-agent
Busca Bootstrap sent successfully, y luego Heartbeat sent successfully
cada 30 segundos.
/var/run/docker.sock y /var/lib/neurogrid/workloads no son rutas de
Windows y no necesitas crearlas. Se resuelven dentro de la VM Linux de Docker
Desktop, donde viven tanto el contenedor del agente como el daemon de
Docker.
Mantén la máquina despierta
Una laptop con Windows que se suspende deja de servir, y un trabajo en curso falla. Antes de dejar un host corriendo:
- Configuración → Sistema → Energía y batería → Pantalla y suspensión — pon la suspensión en Nunca mientras está conectada.
- Desactiva Inicio rápido si la máquina se reinicia sin supervisión (Panel de control → Opciones de energía → Elegir el comportamiento de los botones de encendido).
Docker Desktop tiene que estar corriendo
El agente es un contenedor, así que solo corre mientras Docker Desktop también lo hace. Activa Iniciar Docker Desktop al iniciar sesión (Configuración → General), y ten en cuenta que esto significa que la máquina tiene que iniciar sesión después de un reinicio — un host sin supervisión está mejor en Linux.