IronFlock Appliance

L’IronFlock Appliance è un box pre-configurato e autonomo che viene consegnato con l’intero sistema IronFlock pronto all’uso. Viene posizionato in loco accanto alle macchine che gestisce — nessuna DMZ, nessuna VPC, nessun cluster Kubernetes richiesto.

Pensalo come IronFlock in una scatola.

A Chi è Destinato

L’Appliance si rivolge a due pubblici principali:

Produttori di macchine e OEM che desiderano offrire servizi digitali insieme alle loro macchine. Invece di chiedere al cliente finale di aprire la propria DMZ o di provisionare infrastruttura cloud, il produttore consegna l’IronFlock Appliance, comprensivo del proprio servizio digitale, come parte della fornitura della macchina. Il cliente lo collega alla rete locale e funziona.
Piccole fabbriche con un team IT ridotto che vogliono una piattaforma IoT locale e chiavi in mano senza dover gestire uno stack Kubernetes completo. L’Appliance arriva pre-configurato, si installa in pochi minuti e mantiene tutti i dati in loco — offrendo alle piccole realtà gli stessi dashboard, la stessa gestione delle app e lo stesso controllo dei dispositivi di un deployment cloud completo, senza l’onere infrastrutturale.

In Cosa Differisce da un Deployment in Cloud Privato

Sia l’Appliance che il deployment in cloud privato eseguono IronFlock localmente. La differenza principale riguarda portata e complessità:

Il cloud privato è un’installazione IT completa — viene eseguito nella DMZ o VPC del cliente, gestito dal team IT del cliente, e può servire molti account e progetti in tutta l’organizzazione.
L’Appliance è un box compatto e chiavi in mano — arriva pre-configurato, si colloca sulla rete locale accanto alle macchine e non richiede alcun coinvolgimento IT da parte del cliente. È progettato per un numero limitato di macchine.

Per Iniziare

Avviare la tua istanza IronFlock locale di fabbrica richiede pochi minuti. Da un PC industriale nudo a una piattaforma completamente funzionante — tre passi, un comando, nessuna configurazione manuale.

Requisiti

Un PC industriale con sistema operativo Linux (o una macchina virtuale) con accesso a internet durante l’installazione.
Architettura ARM64 o AMD64.
Minimo: 2 core CPU, 2 GB di RAM, 24 GB di storage. Per cronologie di dati analitici raccolti dalle macchine, è consigliato uno storage molto più ampio (ad esempio > 500 GB).

Passi

Crea un account su ironflock.com.
Genera una Instance Key — nell’interfaccia IronFlock, apri il tuo Profilo → Istanze, scegli il piano più adatto al tuo caso d’uso e crea una nuova Instance Key. Copia la chiave.
Esegui l’installer sull’host dell’Appliance. Apri un terminale sul tuo PC industriale ed esegui il seguente comando. Scarica e configura il software IronFlock e avvia lo stack — completamente in modalità non assistita:
```
# Dietro un proxy aziendale? Consulta la nota qui sotto prima di eseguire questo comando.
curl -fsSL https://instance-registry.ironflock.com/dl/appliance/install_ironflock.sh \
  | sudo bash -s -- <your-instance-key>
```
Sostituisci <your-instance-key> con la chiave del passo 2.

Dietro un proxy aziendale? Se l’Appliance raggiunge internet solo attraverso un proxy HTTP aziendale, devi fornirlo nel comando di installazione affinché il daemon Docker possa scaricare le immagini — altrimenti l’installazione si blocca al passo di login. Consulta Dietro un Proxy Aziendale.

Tutto qui. Una volta terminato l’installer, l’Appliance avvia la piattaforma IronFlock completa e si riavvierà automaticamente al riavvio del sistema.

Accedi alla tua Istanza da ironflock.com

Anche se l’Appliance è una piattaforma totalmente locale, non devi essere sulla rete della fabbrica per utilizzarlo. Finché l’Appliance ha una connessione internet e il tuo account Appliance è connesso al tuo account su ironflock.com (vedi Collegamento degli Account), puoi passare alla tua istanza direttamente dall’interfaccia cloud IronFlock — niente VPN, niente port forwarding, nessuno strumento aggiuntivo.

Questo significa:

Un’interfaccia unificata — gestisci i tuoi progetti cloud e le tue istanze Appliance fianco a fianco da un’unica scheda del browser.
Lavora da qualsiasi luogo — operatori, sviluppatori e personale di supporto possono raggiungere l’Appliance via internet, mentre tutti i dati di produzione e i workload restano locali sull’Appliance.
Visione multi-sito semplificata — se gestisci più Appliance in fabbriche diverse, ognuna compare nel tuo account ironflock.com ed è a un clic di distanza.

Quando l’Appliance perde la connessione a internet, continua a funzionare localmente e resta raggiungibile dall’interno della rete della fabbrica all’indirizzo http://<appliance-host> — solo l’accesso remoto si mette in pausa finché la connettività non torna.

Configurazione del Firewall

Se l’Appliance opera in una rete locale con restrizioni, abilita l’accesso in uscita verso i seguenti endpoint IronFlock affinché possa raggiungere il cloud. Tutte le connessioni sono avviate dall’Appliance — non è necessario aprire alcuna porta in ingresso sul tuo firewall.


instance-registry.ironflock.com:443   # download e aggiornamento del software IronFlock e degli agenti
cbw.ironflock.com:443                 # gestione remota dell'Appliance dal cloud
web.ironflock.com:443                 # attivazione della licenza e abilitazione delle funzionalità AI
registry.ironflock.com:443            # download delle immagini delle app durante la sincronizzazione dall'IronFlock Store pubblico
regauth.ironflock.com:443             # autenticazione di tali download di immagini dallo Store pubblico
smtp-proxy.ironflock.com:2525         # invio di e-mail di account e notifica (opzionale)

Le voci registry.ironflock.com e regauth.ironflock.com sono necessarie per sincronizzare le app dall’IronFlock Store pubblico nel Local App Store. registry.ironflock.com serve le immagini delle app e regauth.ironflock.com emette il token che autorizza ogni download — entrambi devono essere raggiungibili, altrimenti la sincronizzazione (e la navigazione/installazione remota delle app) fallisce. Se il tuo Appliance serve esclusivamente app create localmente, puoi ometterli.

La voce smtp-proxy.ironflock.com è necessaria solo se utilizzi il relay e-mail integrato di IronFlock. Se configuri il tuo server SMTP, puoi ometterla.

Se la tua rete raggiunge internet solo attraverso un proxy HTTP aziendale, consulta Dietro un Proxy Aziendale — l’installer può indirizzare automaticamente il daemon Docker verso il tuo proxy.

Ciclo di Vita della Licenza

La tua licenza è vincolata a un singolo Appliance fisico. La stessa licenza non può eseguire una seconda istanza IronFlock su hardware diverso contemporaneamente. Per l’operatività quotidiana, l’Appliance funziona offline — dati di produzione, dashboard, gestione delle app e controllo dei dispositivi edge restano tutti localmente sul box.

Quando l’Appliance Necessita di Internet

Una connessione internet è richiesta solo in questi momenti:

Installazione iniziale e aggiornamenti dell’Appliance — necessaria in ogni caso per scaricare il software dai server di distribuzione IronFlock; la licenza viene attivata come parte dello stesso passaggio.
Ricontrollo periodico della licenza — dipende dal tuo piano:
- Licenza mensile: una volta ogni 30 giorni.
- Licenza annuale: una volta ogni 365 giorni.
- Licenza perpetua: nessun ricontrollo periodico — internet serve solo all’installazione e in occasione degli aggiornamenti.
Trasferimento della licenza a nuovo hardware (vedi sotto).
Servizio AI Multi Agent — solo mentre è attivamente in uso.

Periodo di Grazia e Blocco

Se un ricontrollo periodico non riesce a raggiungere il cloud (interruzione di rete, errore transitorio del cloud), l’Appliance entra in un periodo di grazia di 7 giorni. Durante la grazia, l’Appliance continua a funzionare normalmente e ritenta automaticamente.

Se trascorrono sette giorni interi senza un ricontrollo riuscito, l’Appliance si blocca da solo: la maggior parte delle operazioni viene rifiutata e l’interfaccia mostra la licenza come non valida. Per ripristinare, ristabilisci la connessione internet dell’Appliance e clicca su Riconvalida ora nel pannello licenze del tuo profilo nell’interfaccia dell’Appliance (la vista locale http://<appliance-host>, oppure la tua istanza acceduta tramite ironflock.com).

Trasferire la Licenza su Nuovo Hardware (Handover)

Una licenza è vincolata all’impronta hardware di una singola macchina. Per trasferirla su una macchina diversa, avvii un handover dal tuo profilo cloud IronFlock:

Apri Profilo → Istanze su ironflock.com.
Clicca su Reimposta impronta hardware sull’istanza che vuoi trasferire.

L’handover richiede che l’Appliance attualmente vincolato sia online. Il cloud si riconnette all’Appliance, gli chiede di revocarsi localmente e solo allora cancella l’impronta lato cloud. Questo handshake garantisce che il vecchio Appliance non possa continuare a funzionare mentre un nuovo Appliance si vincola — evitando l’uso doppio accidentale della stessa licenza.

Una volta riuscito lo sblocco:

Configura il nuovo hardware seguendo i passi di Per Iniziare, utilizzando la stessa instance key.
Il nuovo Appliance si valida, vincola la propria impronta e diventa il dispositivo attivo.

Quando il Vecchio Hardware è Guasto o Inaccessibile

Se l’Appliance precedentemente vincolato è morto o altrimenti irraggiungibile, l’handshake andrà in timeout e l’interfaccia cloud mostra appliance_unreachable_contact_support. In tal caso, contatta il team IronFlock — possiamo cancellare il vincolo manualmente dopo aver verificato la proprietà.

Suggerimento: avvia l’handover prima di dismettere il vecchio hardware, mentre è ancora online. Il processo è molto più rapido — per te e per il nostro team di supporto — quando il vecchio Appliance è ancora raggiungibile.

Operatività Locale

Se non vuoi mantenere l’Appliance online, puoi sempre usare un browser nella stessa rete locale e navigare all’indirizzo IP o all’hostname dell’Appliance:


http://<appliance-host>

Accedi con le credenziali predefinite:

Nome utente: admin
Password: ironflock

Non dimenticare di cambiare le credenziali admin al primo accesso.

UI Web delle App

Quando un’app su un dispositivo connesso espone un’interfaccia web, l’Appliance la rende raggiungibile attraverso il suo tunnel integrato. Pronto all’uso, non richiede nulla dall’IT aziendale — ogni UI di app viene pubblicata su HTTP semplice su una porta assegnata automaticamente dell’indirizzo dell’Appliance (http://<appliance-host>:<port>), e la IronFlock UI mostra il link. L’accesso resta protetto dal login dell’Appliance.

Per URL https:// affidabili su una rete aziendale condivisa — usando un certificato wildcard dalla tua CA o un reverse proxy che termina TLS — vedi UI delle App e HTTPS.

Collegamento degli Account

Crea account utente locali per il tuo team invitandoli via e-mail nelle impostazioni del progetto sull’Appliance. L’e-mail di invito contiene tutto ciò di cui l’invitato ha bisogno:

Un link di connessione personale — aprendolo su ironflock.com si connette l’account ironflock.com dell’invitato all’Appliance. Se non ha ancora un account ironflock.com, deve prima crearne uno usando l’indirizzo e-mail dell’invito (la connessione viene concessa solo quando i due indirizzi e-mail corrispondono). Una volta connesso, l’Appliance compare nel suo selettore di progetti su ironflock.com e può lavorarci da remoto fin da subito — nessuna chiave manuale, nessuna registrazione locale richiesta.
Un link di registrazione locale — opzionale: completando la registrazione locale può inoltre accedere direttamente dall’interfaccia dell’Appliance (http://<appliance-host>).

Alcune cose da sapere:

Gli utenti locali esistenti non hanno bisogno di un nuovo invito dal proprietario del progetto. Nell’interfaccia dell’Appliance aprono il proprio Profilo e cliccano su Inviami il link di connessione via email nella sezione Connetti a ironflock.com.
Reinvio: invitare di nuovo lo stesso indirizzo e-mail (o cliccare di nuovo il pulsante nel profilo) genera un nuovo link di connessione. È valido solo il link dell’e-mail più recente.
Se l’Appliance non può inviare e-mail — ad esempio su una rete aziendale con restrizioni che blocca il relay di posta — il link di connessione viene invece mostrato direttamente nell’interfaccia: chi invita lo copia e lo consegna attraverso un canale qualsiasi. Il link deve essere aperto in un browser con accesso a internet.
Disconnessione: un utente può rimuovere la connessione in qualsiasi momento su ironflock.com in Profilo → Istanze → Istanze connesse. Riaprendo il link di connessione più recente, la connessione viene ripristinata.

Il proprietario dell’istanza — l’utente che ha creato la Instance Key su ironflock.com — viene connesso automaticamente all’account admin locale dell’istanza; per il proprietario non è necessario alcun invito.

Aggiungere Dispositivi Edge

Con dispositivi edge aggiuntivi (ovvero PC industriali) puoi distribuire app IronFlock a più macchine e alleggerire le operazioni delle app dall’Appliance. L’Appliance stesso funge già da dispositivo edge, ma puoi collegare ulteriori dispositivi edge nello stesso modo in cui distribuiresti dispositivi edge nel cloud IronFlock. Vai semplicemente su Impostazioni Progetto -> Dispositivi -> Nuovo Dispositivo e segui le istruzioni.

Manutenzione

Per aggiornare il sistema IronFlock sull’Appliance, l’admin può utilizzare il pulsante di aggiornamento nella sezione licenze del proprio profilo ogniqualvolta è disponibile una nuova versione. L’Appliance necessita di una connessione internet per scaricare l’aggiornamento. IronFlock si riavvia automaticamente al termine dell’aggiornamento.

Gli aggiornamenti del sistema operativo Linux sono a tua responsabilità.

Mittente E-mail Personalizzato (SMTP)

Per impostazione predefinita, tutte le e-mail della piattaforma — verifica account, recupero password, inviti e notifiche di allarme — vengono inoltrate tramite il proxy SMTP cloud di IronFlock e appaiono come no-reply@ironflock.com. Per far apparire le e-mail come inviate dalla tua azienda, puoi configurare l’Appliance affinché utilizzi il tuo server SMTP.

Sull’host dell’Appliance, modifica il file di ambiente generato dall’installer in /opt/ironflock/.env e imposta le seguenti variabili:


SMTP_CONNECTION_URI=smtps://USERNAME:PASSWORD@smtp.your-company.com:465/
SMTP_FROM_ADDRESS=no-reply@your-company.com
SMTP_FROM_NAME=Your Company

Usa smtps:// per TLS implicito (in genere porta 465), oppure smtp:// con STARTTLS (porta 587).
Codifica in URL i caratteri speciali presenti nel nome utente o nella password (es. @ → %40).
SMTP_FROM_ADDRESS e SMTP_FROM_NAME determinano ciò che i destinatari vedono nell’intestazione Da di ogni e-mail della piattaforma.

Applica le modifiche riavviando lo stack:


sudo systemctl restart ironflock.service

Dopo il riavvio, tutte le e-mail di autenticazione, le notifiche della piattaforma e le e-mail di allarme vengono inviate tramite il tuo server SMTP con l’indirizzo e il nome del mittente della tua azienda.

Se SMTP_CONNECTION_URI non è impostato, l’Appliance continua a instradare le e-mail tramite il proxy SMTP cloud di IronFlock autenticato con la tua chiave di licenza — nessuna configurazione aggiuntiva richiesta, ma le e-mail riporteranno il branding IronFlock.

Cosa c’è nella Scatola

L’Appliance viene consegnato con tutti i servizi IronFlock pre-installati e pre-configurati:

Interfaccia IronFlock accessibile dalla rete locale
Local App Store per la distribuzione offline delle app
Board Studio, Alarms e Data Store
Sistema AI Multi Agent (funziona solo quando connesso a internet)

Dispositivo Edge e Server in Uno

L’Appliance non si limita a eseguire la piattaforma IronFlock — può contemporaneamente agire come dispositivo edge nel contesto IronFlock. Ciò significa che può eseguire app containerizzate come qualsiasi altro dispositivo gestito, fungendo al contempo da nodo centrale di gestione per gli altri dispositivi sulla stessa rete. Questo lo rende una soluzione compatta e completa: server della piattaforma ed edge computing in un unico box.

Poiché l’Appliance esegue lo stesso agente dispositivo IronFlock di qualsiasi dispositivo edge gestito, beneficia anche delle protezioni di Connettività e resilienza dell’agente — riconnessione di rete automatica all’infinito, lo stato di Emergenza spazio di archiviazione che mantiene il box raggiungibile e si ripristina automaticamente quando il disco si riempie, la protezione dall’esaurimento della memoria e un agente che si riavvia da solo. Questa è una ragione chiave per cui l’Appliance — e il tuo accesso remoto ad esso — resta online attraverso problemi di rete locale, di disco e di memoria.

Architettura

Hardware

L’hardware dell’Appliance è negoziabile ed è tipicamente fornito dall’OEM o dal produttore della macchina. IronFlock fornisce lo stack software e pre-configura il sistema sull’hardware scelto prima della spedizione. Tipicamente, un PC industriale edge di medie dimensioni (4 core, 8 GB di RAM) è sufficiente per eseguire l’intero stack insieme ad applicazioni aggiuntive. Contatta il team IronFlock per discutere i requisiti hardware per il tuo caso d’uso.

Sincronizzazione delle App dallo Store Online

L’Appliance include un local App Store — un catalogo di app privato e un registro container che serve le app ai dispositivi sulla rete locale. Puoi popolare questo store locale sincronizzando le app dall’IronFlock Store pubblico online, a condizione che l’Appliance disponga di una connessione internet al momento della sincronizzazione. Non è richiesta una connessione internet permanente; una connessione temporanea è sufficiente per scaricare le app di cui hai bisogno.

Prerequisiti

Un account sulla piattaforma pubblica ironflock.com.
Il tuo account Appliance è connesso al tuo account ironflock.com (vedi Collegamento degli Account). L’account admin del proprietario dell’istanza viene connesso automaticamente.

Come Funziona la Sincronizzazione delle App


┌────────────────────┐                       ┌────────────────────┐
│  Online IronFlock  │  ◄──── account ─────► │  Appliance         │
│  Store (cloud)     │      connection       │  local Store       │
└────────────────────┘                       └────────────────────┘
         │                                            │
   apps available to                          sync button shown
   the connected account                      instead of install

Apri il local App Store — Quando l’Appliance ha una connessione internet attiva, l’App Store mostrerà tutte le app disponibili per il tuo account ironflock.com connesso sulla piattaforma online.
Sincronizza le app di cui hai bisogno — Invece di un pulsante Install, ogni app mostra un pulsante Sync. Cliccandolo si scarica l’app — incluse le immagini dei container e i metadati — dallo store online allo store locale.
Aggiungi i dispositivi — Una volta sincronizzata, l’app è completamente disponibile nel tuo store locale e puoi aggiungere dispositivi normalmente, senza necessità di connessione internet.

Flusso di Aggiornamento

Quando una nuova versione di un’app sincronizzata viene pubblicata nello store online, apparirà di nuovo un pulsante Sync per quell’app. Collega l’Appliance a internet per un breve periodo, sincronizza la release aggiornata, quindi distribuiscila ai tuoi dispositivi tramite il normale flusso di aggiornamento delle app.

Questo design ti dà pieno controllo su ciò che entra nella tua rete — nulla viene scaricato automaticamente e la connessione internet è necessaria solo durante la fase di sincronizzazione.

Limitazioni

Account master singolo per AppStudio — L’Appliance può ospitare un ambiente AppStudio per un solo account master. Lo sviluppo delle app è limitato a una singola organizzazione.
Scala limitata — L’Appliance è dimensionato per un insieme circoscritto di macchine in un’unica sede. Flotte che si estendono su più siti o decine di migliaia di dispositivi sono meglio servite dal cloud o da un deployment in cloud privato.
I servizi AI richiedono accesso LLM in uscita — Consulta Cloud privato per le opzioni quando l’Appliance non ha alcun accesso a internet.

Contattaci

I deployment Appliance vengono configurati in collaborazione con il team IronFlock. Contattaci per discutere i tuoi requisiti di hardware, numero di macchine e branding.