Operación
Operación local
Si no quieres mantener el appliance en línea, siempre puedes usar un navegador en la misma red local y navegar a la dirección IP o nombre del appliance:
http://<appliance-host>Inicia sesión como usuario admin:
- Usuario:
admin - Contraseña: la contraseña inicial de admin generada para tu appliance
ironflock appliance install muestra esta contraseña una sola vez, en el terminal, al final de la instalación. También queda guardada como APPLIANCE_ADMIN_PASSWORD en /opt/ironflock/.env en el host del appliance, un archivo que solo root puede leer:
sudo grep '^APPLIANCE_ADMIN_PASSWORD=' /opt/ironflock/.envCambia la contraseña después de tu primer inicio de sesión.
¿Olvidaste la contraseña de admin? Ejecuta esto en el host del appliance para definir una nueva:
sudo ironflock appliance reset-admin-passwordEl appliance tiene que estar en marcha. El comando define la contraseña nueva y cierra todas las sesiones activas del admin. Muestra la contraseña nueva una sola vez, y solo en un terminal; sin terminal, o con --json, indica en su lugar dónde está guardada. Consulta ironflock appliance reset-admin-password.
Appliances más antiguos: un appliance instalado antes de que la instalación generara la contraseña de admin empieza con la contraseña
ironflock. El primer inicio de sesión con ella te pide que definas una contraseña nueva.
UI web de las apps
Cuando una app en un dispositivo conectado expone una interfaz web, el appliance la hace alcanzable a través de su túnel integrado. De fábrica esto no requiere nada del IT corporativo — cada UI de app se publica por HTTP simple en un puerto asignado automáticamente de la dirección del appliance (http://<appliance-host>:<port>), y la IronFlock UI muestra el enlace. El acceso sigue estando protegido por el inicio de sesión del appliance.
Para URLs https:// de confianza en una red corporativa compartida — usando un certificado comodín de tu CA o un proxy inverso que termina TLS — consulta UI de las apps y HTTPS.
Vincular cuentas
Crea cuentas de usuario locales para tu equipo invitándolos por correo electrónico desde la configuración de tu proyecto en el appliance. El correo de invitación contiene todo lo que el invitado necesita:
- Un enlace de conexión personal — al abrirlo en ironflock.com se conecta la cuenta de ironflock.com del invitado con el appliance. Si todavía no tiene una cuenta en ironflock.com, primero debe crear una usando la dirección de correo invitada (la conexión solo se concede cuando ambas direcciones de correo coinciden). Una vez conectado, el appliance aparece en su selector de proyectos de ironflock.com y puede trabajar en él de forma remota de inmediato — sin claves manuales ni registro local.
- Un enlace de registro local — opcional: completar el registro local le permite además iniciar sesión directamente en la UI del appliance (
http://<appliance-host>).
Algunas cosas que conviene saber:
- Los usuarios locales existentes no necesitan una nueva invitación del propietario del proyecto. En la UI del appliance, abren su Perfil y hacen clic en Enviarme el enlace de conexión por correo en la sección Conectar a ironflock.com.
- Reenvío: invitar de nuevo a la misma dirección de correo (o volver a hacer clic en el botón del perfil) genera un enlace de conexión nuevo. Solo es válido el enlace del correo más reciente.
- Si el appliance no puede enviar correos — por ejemplo en una red corporativa restringida que bloquea el relay de correo — el enlace de conexión se muestra directamente en la UI: quien invita lo copia y lo entrega por cualquier canal. El enlace debe abrirse en un navegador con acceso a internet.
- Desconectar: un usuario puede eliminar la conexión en cualquier momento en ironflock.com, en Perfil → Instancias → Instancias conectadas. Volver a abrir el enlace de conexión más reciente la restablece.
El propietario de la instancia — el usuario que creó la Instance Key en ironflock.com — se conecta automáticamente con la cuenta local de admin de la instancia; el propietario no necesita invitación.
Sincronización de apps desde la Store online
El Appliance incluye una App Store local — un catálogo privado de apps y registro de contenedores que sirve apps a los dispositivos de la red local. Puedes poblar esta store local sincronizando apps desde la Store online pública de IronFlock, siempre que el Appliance disponga de conexión a internet en el momento de la sincronización. No se requiere una conexión permanente a internet; una conexión temporal es suficiente para descargar las apps que necesites.
Requisitos previos
- Una cuenta en la plataforma pública ironflock.com.
- Tu cuenta del appliance está conectada a tu cuenta de ironflock.com (consulta Vincular cuentas). La cuenta de admin del propietario de la instancia se conecta automáticamente.
Cómo funciona la sincronización de apps
┌────────────────────┐ ┌────────────────────┐
│ Online IronFlock │ ◄──── account ─────► │ Appliance │
│ Store (cloud) │ connection │ local Store │
└────────────────────┘ └────────────────────┘
│ │
apps available to sync button shown
the connected account instead of install- Abre la App Store local — Cuando el Appliance disponga de conexión activa a internet, el App Store mostrará todas las apps disponibles para tu cuenta de ironflock.com conectada en la plataforma online.
- Sincroniza las apps que necesites — En lugar de un botón Install, cada app muestra un botón Sync. Al pulsarlo se descarga la app — incluidas sus imágenes de contenedor y metadatos — desde la store online a la store local.
- Añade dispositivos — Una vez sincronizada, la app está totalmente disponible en tu store local y puedes añadir dispositivos como de costumbre, sin necesidad de conexión a internet.
Flujo de actualización
Cuando se publique una nueva versión de una app sincronizada en la store online, volverá a aparecer un botón Sync para esa app. Conecta brevemente el Appliance a internet, sincroniza la nueva release y despliégala a tus dispositivos mediante el flujo estándar de actualización de apps.
Este diseño te da control total sobre lo que entra en tu red — no se descarga nada de forma automática, y la conexión a internet solo es necesaria durante el paso de sincronización.
Remitente de correo personalizado (SMTP)
Por defecto, todos los correos de la plataforma — verificación de cuenta, recuperación de contraseña, invitaciones y notificaciones de alarmas — se envían a través del proxy SMTP en la nube de IronFlock y aparecen como [email protected]. Para que los correos aparezcan como enviados por tu propia empresa, configura el appliance para que use tu propio servidor SMTP.
En el host del appliance, edita el archivo de entorno del appliance en /opt/ironflock/.env y define las siguientes variables:
SMTP_CONNECTION_URI=smtps://USERNAME:[email protected]:465/
SMTP_FROM_ADDRESS=[email protected]
SMTP_FROM_NAME=Your Company- Usa
smtps://para TLS implícito (típicamente puerto465), osmtp://con STARTTLS (puerto587). - Codifica en URL los caracteres especiales del usuario o la contraseña (por ejemplo
@→%40). SMTP_FROM_ADDRESSySMTP_FROM_NAMEson lo que ven los destinatarios en el encabezado De de cada correo de la plataforma.
Aplica los cambios reiniciando el appliance:
sudo ironflock appliance restartTras el reinicio, todos los correos de autenticación, notificaciones de la plataforma y correos de alarma se envían a través de tu servidor SMTP con la dirección y el nombre de remitente de tu empresa.
Si
SMTP_CONNECTION_URIno está definido, el appliance sigue enrutando los correos a través del proxy SMTP en la nube de IronFlock autenticado con tu clave de licencia — no requiere configuración adicional, pero los correos llevarán la marca IronFlock.
Mantenimiento
Para actualizar el sistema IronFlock en tu appliance, el admin puede usar el botón de actualización en la sección de licencia de su perfil cuando haya una nueva versión disponible. En el host del appliance, la misma actualización se ejecuta con:
sudo ironflock appliance updateEl appliance necesita conexión a internet para descargar la actualización. IronFlock se reinicia automáticamente cuando termina la actualización.
El appliance solo instala una actualización con una firma válida de IronFlock y, si una actualización falla, vuelve a la versión que ejecutaba antes (consulta Actualizaciones e ironflock appliance update).
El botón de actualización también ejecuta el ironflock de /usr/local/bin en el host del appliance. Cuando una versión necesita un ironflock más reciente, la actualización lo instala primero, con las comprobaciones de ironflock self-update, y continúa con él (Un ironflock más reciente). Un ironflock de la versión 2.2.0 o anterior no puede hacerlo: ejecuta una vez la línea de instalación para llevarlo a la versión actual (Desde el release 2.2.0 o anterior).
Las actualizaciones del sistema operativo Linux son responsabilidad tuya.
Conexión a la nube
El appliance mantiene una conexión saliente con ironflock.com. A través de ella trabajas en la instancia desde ironflock.com (consulta Accede a tu instancia desde ironflock.com), abres en remoto las interfaces de usuario y los archivos de las apps, e inicias desde la nube las actualizaciones y el traspaso de licencia. Si el appliance no debe ser accesible desde ironflock.com, desactiva esta conexión.
Mientras la conexión a la nube está desactivada:
- El appliance no es accesible desde ironflock.com. La lista de instancias en ironflock.com lo muestra como Conexión a la nube desactivada.
- El acceso remoto a las interfaces de usuario y los archivos de las apps a través de ironflock.com se detiene.
- Las actualizaciones del appliance y el traspaso de licencia no se pueden iniciar desde la nube. El admin puede seguir actualizando el appliance localmente (consulta Mantenimiento).
- Los informes de uso se quedan en el appliance y se envían en cuanto la conexión vuelve a estar activada.
- Los dispositivos, la operación local, la sincronización de apps desde la Store online y la validación de la licencia siguen funcionando.
El ajuste se mantiene tras los reinicios y las actualizaciones del appliance.
Activarla y desactivarla en el appliance
El admin activa y desactiva la conexión a la nube en la sección Conexión a la nube de la sección de licencia de su perfil, en la UI del appliance (http://<appliance-host>). Solo la cuenta de administrador puede cambiarla, y solo en local — no mientras se trabaja en la instancia desde ironflock.com.
Desactivarla desde ironflock.com
El propietario de la instancia — la cuenta de ironflock.com que creó la Instance Key — puede desactivar la conexión a la nube desde la nube: abre Perfil → Instancias en ironflock.com y haz clic en Desactivar la conexión a la nube en la instancia. El appliance debe estar en línea.
Esto no se puede deshacer desde la nube. Solo el admin del appliance puede volver a activar la conexión, localmente en el appliance.
Ciclo de vida de la licencia
Tu licencia está vinculada a un Appliance físico concreto. La misma licencia no puede ejecutar una segunda instancia de IronFlock en hardware distinto al mismo tiempo. Para la operación diaria, el Appliance funciona sin conexión — los datos de producción, los dashboards, la gestión de apps y el control de dispositivos de borde permanecen en local en la propia caja.
Cuándo necesita internet el Appliance
Solo se requiere conexión a internet en los siguientes momentos:
- Instalación inicial y actualizaciones del Appliance — necesaria de todos modos para descargar el software desde los servidores de distribución de IronFlock; la licencia se activa como parte del mismo paso.
- Revalidación periódica de la licencia — depende de tu plan:
- Licencia mensual: una vez cada 30 días.
- Licencia anual: una vez cada 365 días.
- Licencia perpetua: sin revalidación periódica — solo se necesita internet en la instalación y en las actualizaciones.
- Traspaso de licencia a nuevo hardware (ver más abajo).
- Servicio AI Multi Agent — únicamente mientras está en uso activo.
Periodo de gracia y bloqueo
Si una revalidación periódica no consigue alcanzar la nube (caída de red, error transitorio en la nube), el Appliance entra en un periodo de gracia de 7 días. Durante la gracia, el Appliance sigue funcionando con normalidad y reintenta automáticamente.
Si transcurren siete días completos sin una revalidación correcta, el Appliance se bloquea a sí mismo: la mayoría de las operaciones se rechazan y la UI muestra la licencia como no válida. Para recuperar el estado normal, restablece la conexión a internet del Appliance y haz clic en Revalidar ahora en el panel de licencia de tu perfil en la UI del Appliance (la vista local http://<appliance-host>, o tu instancia accedida a través de ironflock.com).
Mover tu licencia a nuevo hardware (traspaso)
Una licencia está vinculada a la huella de hardware de una máquina concreta. Para moverla a una máquina diferente, debes iniciar un traspaso desde tu perfil en la nube de IronFlock:
- Abre Perfil → Instancias en ironflock.com.
- Haz clic en Restablecer huella de hardware en la instancia que quieras mover.
El traspaso requiere que el Appliance actualmente vinculado esté en línea con su conexión a la nube activada. La nube se conecta de vuelta a él, le pide que se revoque a sí mismo localmente y solo entonces borra la huella en el lado de la nube. Este handshake garantiza que el Appliance antiguo no pueda seguir funcionando mientras uno nuevo se vincula — evitando el uso dual accidental de la misma licencia.
Una vez que el desbloqueo se completa correctamente:
- Configura el nuevo hardware siguiendo los pasos de Instalación, usando la misma Instance Key.
- El nuevo Appliance se valida, vincula su huella y pasa a ser el dispositivo activo.
Cuando el hardware antiguo está averiado o inaccesible
Si el Appliance previamente vinculado está fuera de servicio o no es accesible por cualquier otro motivo, el handshake agotará el tiempo de espera y la UI en la nube mostrará appliance_unreachable_contact_support. En ese caso, contacta con el equipo de IronFlock — podemos borrar la vinculación manualmente tras verificar la titularidad.
Sugerencia: inicia el traspaso antes de retirar el hardware antiguo, mientras siga en línea. El proceso es mucho más rápido — para ti y para nuestro equipo de soporte — cuando todavía se puede alcanzar el Appliance antiguo.