Conectar dispositivos

IronFlock admite múltiples formas de conectar dispositivos, según el hardware y el sistema operativo. ¿No tienes hardware a mano? Puedes simular un dispositivo en tu portátil en cuestión de minutos.

Requisitos previos

Antes de conectar un dispositivo, asegúrate de tener:

Un proyecto creado en IronFlock
Una entrada de dispositivo creada dentro de ese proyecto (haz clic en NEW DEVICE en el panel Settings -> Devices del proyecto.)
El archivo de configuración del dispositivo descargado (.flock)

Prueba primero: Simula un dispositivo en tu portátil

No necesitas hardware físico para explorar IronFlock. La app FlockFlasher puede ejecutar el agente de IronFlock directamente en tu portátil, de modo que tu portátil se hace pasar por un dispositivo real dentro de tu proyecto — perfecto para probar apps y dashboards antes de pasar al hardware real.

Instala Docker Desktop (o Docker Engine en Linux) y asegúrate de que esté en ejecución.
Descarga e instala la app FlockFlasher para tu sistema operativo.
Haz doble clic en el archivo .flock descargado de tu dispositivo — se abre en FlockFlasher y el dispositivo aparece en la lista. (Como alternativa, abre FlockFlasher y carga el archivo con el botón +.)
Haz clic en Test Device (▶, probar dispositivo) en la entrada del dispositivo. FlockFlasher descarga automáticamente el agente de IronFlock la primera vez que lo usas y lo inicia con la configuración de tu dispositivo.

Tu portátil ahora actúa como este dispositivo dentro de tu proyecto de IronFlock: aparece en línea y puedes instalar y ejecutar apps en él exactamente igual que en un dispositivo real. Las apps se ejecutan como contenedores Docker en tu portátil.

Cuando termines, detén la prueba en FlockFlasher. Más adelante puedes usar el mismo archivo .flock para aprovisionar el dispositivo real — solo asegúrate de que una misma configuración de dispositivo no se ejecute en más de una máquina a la vez.

Método 1: Flashear una tarjeta SD

Ideal para Raspberry Pi y otros dispositivos ARM que arrancan desde tarjetas SD.

Descarga la app FlockFlasher para tu sistema operativo.
Inserta una tarjeta SD (mínimo 16 GB) en tu computadora.
Abre FlockFlasher y haz clic en el botón + para cargar el archivo .flock.
Selecciona la unidad de la tarjeta SD (FlockFlasher detecta automáticamente las unidades externas).
Elige la imagen correcta para tu dispositivo (Raspberry Pi 3/4, Zero, etc.).
Opcionalmente configura WiFi para que el dispositivo pueda conectarse en su destino.
Haz clic en Flash y espera a que se completen la escritura, validación y configuración.
Inserta la tarjeta SD en el dispositivo y enciéndelo.

El dispositivo debería conectarse en un plazo de 20 minutos.

Advertencia: El proceso de flasheo borra todos los datos de la unidad seleccionada. FlockFlasher oculta las unidades internas por defecto, pero siempre verifica tu selección.

Método 2: Instalador USB para PCs industriales

Para dispositivos AMD64 con arranque EFI (por ejemplo, Siemens SIMATIC Box IPC).

Inserta una memoria USB (mínimo 16 GB) y abre FlockFlasher.
Carga el archivo .flock y selecciona la unidad USB.
Selecciona la imagen Industrial PC x86_64 (EFI).
Haz clic en Flash y espera a que se complete.
Si es necesario, cambia el orden de arranque en la BIOS del dispositivo para que arranque desde USB.
Inserta la memoria USB y enciende el dispositivo.

El dispositivo debería conectarse en un plazo de 60 minutos.

Método 3: Instalación personalizada

Para dispositivos que mantienen su sistema operativo Linux existente. Ideal para NVIDIA Jetson y hardware personalizado.

Nota: Este método de instalación manual está pensado para hardware de producción real, como PCs industriales, gateways y dispositivos embebidos — no para portátiles. Si solo quieres probar IronFlock en tu portátil, sigue en cambio Prueba primero: Simula un dispositivo en tu portátil — sin necesidad de instalar el agente manualmente.

Dispositivos Linux / Unix

Conéctate al dispositivo por SSH.

Descarga el binario de configuración:


curl -sSL https://instance-registry.ironflock.com/dl/reswarmify/install.sh | bash

Copia el archivo .flock desde tu computadora al dispositivo:
```
scp mydevice.flock user@device-ip:/home/user/
```
Ejecuta el agente:
```
sudo ./ironflock-init -c mydevice.flock
```

¿Detrás de un proxy corporativo? Exporta tu proxy antes del paso 2 para que las descargas funcionen, y pasa --http-proxy / --https-proxy a ironflock-init en el paso 4 para que configure el motor de Docker por ti. Consulta Detrás de un proxy corporativo para ver el comando completo y los pasos para la CA corporativa.

Dispositivos Windows

Instale Docker Desktop en el dispositivo y active Start Docker Desktop when you sign in en la configuración de Docker Desktop. Para dispositivos desatendidos, configure también el inicio de sesión automático de Windows para que Docker esté disponible tras un reinicio sin que nadie inicie sesión.
Descargue reagent.exe.
Copie el archivo .flock al dispositivo.
Instale e inicie el agente como servicio de Windows desde un símbolo del sistema elevado (Administrador):
```
reagent.exe service install -config path\to\config.flock
```
El servicio se inicia de inmediato y de nuevo en cada arranque, se reinicia automáticamente en caso de fallo y mantiene el agente actualizado. Añada -noStart para instalarlo sin iniciarlo y consulte su estado en cualquier momento con reagent.exe service status.

¿Detrás de un proxy corporativo? Añada -proxy http://proxy.example.com:3128 al comando service install y configure el proxy de Docker Desktop en Settings → Resources → Proxies. Consulte Detrás de un proxy corporativo para más detalles y los pasos de la CA corporativa.

Verificar la conexión

Después de conectar, verifica el estado del dispositivo en tu proyecto:

Indicador verde — El dispositivo está en línea y comunicándose con IronFlock.
Indicador rojo — El dispositivo está desconectado. Verifica la conexión de red y asegúrate de que el agente esté en ejecución.

La vista de mapa del dispositivo muestra la ubicación geográfica de todos los dispositivos en el proyecto.