IronFlock Appliance

Die IronFlock Appliance ist eine vorkonfigurierte, eigenständige Box, die mit dem vollständigen, betriebsbereiten IronFlock-System ausgeliefert wird. Sie wird vor Ort direkt neben den Maschinen platziert, die sie verwaltet — keine DMZ, kein VPC, kein Kubernetes-Cluster erforderlich.

Für wen sie gedacht ist

Die Appliance richtet sich an zwei Hauptzielgruppen:

Maschinenhersteller und OEMs, die digitale Dienste gemeinsam mit ihren Maschinen ausliefern möchten. Statt den Endkunden zu bitten, seine DMZ zu öffnen oder Cloud-Infrastruktur bereitzustellen, liefert der Hersteller die IronFlock Appliance inklusive seines digitalen Dienstes als Teil der Maschinenlieferung aus. Der Kunde schließt sie an das lokale Netzwerk an — und sie funktioniert.
Kleine Fabriken mit einem schlanken IT-Team, die eine lokale, schlüsselfertige IoT-Plattform wünschen, ohne einen vollständigen Kubernetes-Stack betreiben zu müssen. Die Appliance kommt vorkonfiguriert, ist in wenigen Minuten installiert und behält alle Daten vor Ort — kleine Betriebe erhalten so dieselben Dashboards, dasselbe App-Management und dieselbe Gerätesteuerung wie bei einer vollständigen Cloud-Bereitstellung, ohne den Infrastruktur-Aufwand.

Unterschied zur Bereitstellung in einer privaten Cloud

Sowohl die Appliance als auch die Bereitstellung in einer privaten Cloud betreiben IronFlock lokal. Der entscheidende Unterschied liegt in Umfang und Komplexität:

Private Cloud ist eine vollständige IT-Installation — sie läuft in der DMZ oder VPC des Kunden, wird vom IT-Team des Kunden betrieben und kann viele Accounts und Projekte in der gesamten Organisation bedienen.
Appliance ist eine kompakte, schlüsselfertige Box — sie wird vorkonfiguriert geliefert, steht im lokalen Netzwerk neben den Maschinen und erfordert keinerlei IT-Aufwand auf Kundenseite. Sie ist für eine begrenzte Anzahl von Maschinen ausgelegt.

Erste Schritte

Eine eigene, fabriknahe IronFlock-Instanz aufzusetzen dauert nur wenige Minuten. Von einem nackten Industrie-PC zu einer voll lauffähigen Plattform — drei Schritte, ein Befehl, keine manuelle Konfiguration.

Voraussetzungen

Ein Industrie-PC mit Linux-Betriebssystem (oder eine virtuelle Maschine) mit Internetzugang während der Installation.
Architektur ARM64 oder AMD64.
Minimum: 2 CPU-Kerne, 2 GB RAM, 24 GB Speicher. Für analytische Datenhistorien, die von Maschinen erfasst werden, wird deutlich mehr Speicher empfohlen (z. B. > 500 GB).

Schritte

Erstellen Sie ein Konto auf ironflock.com.
Erzeugen Sie einen Instance Key — Öffnen Sie in der IronFlock UI Ihr Profil → Instanzen, wählen Sie den passenden Plan für Ihren Anwendungsfall und erstellen Sie einen neuen Instance Key. Kopieren Sie den Schlüssel.
Starten Sie den Installer auf Ihrem Appliance-Host. Öffnen Sie ein Terminal auf Ihrem Industrie-PC und führen Sie den folgenden Befehl aus. Er lädt die IronFlock-Software herunter, konfiguriert sie und startet den Stack — vollständig unbeaufsichtigt:
```
# Hinter einem Unternehmens-Proxy? Lesen Sie den Hinweis unten, bevor Sie dies ausführen.
curl -fsSL https://instance-registry.ironflock.com/dl/appliance/install_ironflock.sh \
  | sudo bash -s -- <your-instance-key>
```
Ersetzen Sie <your-instance-key> durch den Schlüssel aus Schritt 2.

Hinter einem Unternehmens-Proxy? Wenn die Appliance das Internet nur über einen Unternehmens-HTTP-Proxy erreicht, müssen Sie ihn beim Installationsbefehl angeben, damit der Docker-Daemon die Images herunterladen kann — andernfalls bricht die Installation beim Login-Schritt ab. Siehe Hinter einem Unternehmens-Proxy.

Das war’s. Sobald der Installer fertig ist, startet die Appliance die vollständige IronFlock-Plattform und wird beim Neustart automatisch wieder hochgefahren.

Auf Ihre Instanz über ironflock.com zugreifen

Auch wenn die Appliance eine vollständig lokale Plattform ist, müssen Sie nicht im Werksnetzwerk sein, um sie zu nutzen. Solange die Appliance über eine Internetverbindung verfügt und Ihr Appliance-Konto mit Ihrem Konto auf ironflock.com verbunden ist (siehe Konten verknüpfen), können Sie direkt aus der IronFlock Cloud-UI in Ihre Instanz wechseln — ohne VPN, ohne Portfreigabe, ohne zusätzliche Tools.

Das bedeutet:

Eine einheitliche UI — Verwalten Sie Ihre Cloud-Projekte und Ihre Appliance-Instanzen Seite an Seite in einem einzigen Browser-Tab.
Arbeiten von überall — Operatoren, Entwickler und Support-Mitarbeiter können die Appliance über das Internet erreichen, während alle Produktionsdaten und Workloads lokal auf der Appliance verbleiben.
Einfache Multi-Site-Übersicht — Wenn Sie mehrere Appliances in verschiedenen Werken betreiben, taucht jede davon in Ihrem ironflock.com-Konto auf und ist nur einen Klick entfernt.

Verliert die Appliance ihre Internetverbindung, läuft sie lokal weiter und bleibt aus dem Werksnetz unter http://<appliance-host> erreichbar — nur der Remote-Zugriff pausiert, bis die Verbindung wiederhergestellt ist.

Firewall-Konfiguration

Wenn die Appliance in einem eingeschränkten lokalen Netzwerk läuft, geben Sie den ausgehenden Zugriff auf die folgenden IronFlock-Endpunkte frei, damit sie die Cloud erreichen kann. Alle Verbindungen werden von der Appliance aus initiiert — es müssen keine eingehenden Ports in Ihrer Firewall geöffnet werden.


instance-registry.ironflock.com:443   # Herunterladen und Aktualisieren der IronFlock-Software und Agenten
cbw.ironflock.com:443                 # Remote-Verwaltung der Appliance aus der Cloud
web.ironflock.com:443                 # Aktivieren der Lizenz und Freischalten der KI-Funktionen
registry.ironflock.com:443            # Abrufen von App-Images beim Synchronisieren aus dem öffentlichen IronFlock Store
regauth.ironflock.com:443             # Authentifizieren dieser App-Image-Abrufe aus dem öffentlichen Store
smtp-proxy.ironflock.com:2525         # Versand von Konto- und Benachrichtigungs-E-Mails (optional)

Die Einträge registry.ironflock.com und regauth.ironflock.com werden benötigt, um Apps aus dem öffentlichen IronFlock Store in den lokalen App Store zu synchronisieren. registry.ironflock.com liefert die App-Images und regauth.ironflock.com stellt das Token aus, das jeden Abruf autorisiert — beide müssen erreichbar sein, sonst schlägt die Synchronisierung (sowie das Durchsuchen und Installieren entfernter Apps) fehl. Wenn Ihre Appliance ausschließlich lokal von Ihnen erstellte Apps bereitstellt, können Sie sie weglassen.

Der Eintrag smtp-proxy.ironflock.com wird nur benötigt, wenn Sie das integrierte IronFlock-E-Mail-Relay verwenden. Wenn Sie Ihren eigenen SMTP-Server konfigurieren, können Sie ihn weglassen.

Wenn Ihr Netzwerk das Internet nur über einen Unternehmens-HTTP-Proxy erreicht, siehe Hinter einem Unternehmens-Proxy — der Installer kann den Docker-Daemon automatisch auf Ihren Proxy verweisen.

Lizenz-Lebenszyklus

Ihre Lizenz ist an eine einzelne physische Appliance gebunden. Dieselbe Lizenz kann nicht gleichzeitig eine zweite IronFlock-Instanz auf anderer Hardware betreiben. Im Alltagsbetrieb läuft die Appliance offline — Produktionsdaten, Dashboards, App-Management und die Steuerung der Edge-Geräte bleiben vollständig lokal auf der Box.

Wann die Appliance Internet benötigt

Eine Internetverbindung ist nur zu folgenden Zeitpunkten erforderlich:

Erstinstallation und Appliance-Updates — ohnehin nötig, um die Software von den IronFlock-Distributionsservern zu beziehen; die Lizenz wird im selben Schritt aktiviert.
Periodische Lizenz-Revalidierung — abhängig von Ihrem Tarif:
- Monatliche Lizenz: einmal alle 30 Tage.
- Jährliche Lizenz: einmal alle 365 Tage.
- Unbefristete Lizenz: keine periodische Revalidierung — Internet wird nur bei Installation und bei Updates benötigt.
Lizenz-Übergabe an neue Hardware (siehe unten).
AI Multi Agent-Dienst — nur während der aktiven Nutzung.

Karenzzeit und Sperre

Kann eine periodische Revalidierung die Cloud nicht erreichen (Netzwerkausfall, vorübergehender Cloud-Fehler), tritt die Appliance in eine 7-tägige Karenzzeit ein. Während dieser Karenzzeit läuft die Appliance normal weiter und wiederholt den Versuch automatisch.

Vergehen sieben volle Tage ohne erfolgreiche Revalidierung, sperrt sich die Appliance selbst: Die meisten Operationen werden verweigert, und die UI zeigt die Lizenz als ungültig an. Stellen Sie zur Wiederherstellung die Internetverbindung der Appliance wieder her und klicken Sie im Lizenzbereich Ihres Profils auf der Appliance UI auf Jetzt erneut validieren (die lokale Ansicht unter http://<appliance-host> oder Ihre Instanz, erreichbar über ironflock.com).

Lizenz auf neue Hardware umziehen (Handover)

Eine Lizenz ist an den Hardware-Fingerabdruck einer einzelnen Maschine gebunden. Um sie auf eine andere Maschine umzuziehen, starten Sie einen Handover aus Ihrem IronFlock Cloud-Profil:

Öffnen Sie Profil → Instanzen auf ironflock.com.
Klicken Sie bei der Instanz, die Sie umziehen möchten, auf Hardware-Fingerabdruck zurücksetzen.

Der Handover setzt voraus, dass die aktuell gebundene Appliance online ist. Die Cloud verbindet sich zurück zur Appliance, weist sie an, sich selbst lokal zu widerrufen, und löscht erst danach den Fingerabdruck auf Cloud-Seite. Dieser Handshake stellt sicher, dass die alte Appliance nicht weiterlaufen kann, während eine neue gebunden wird — und verhindert so eine versehentliche Doppelnutzung derselben Lizenz.

Sobald die Entsperrung erfolgreich war:

Richten Sie die neue Hardware gemäß den Schritten unter Erste Schritte ein und verwenden Sie dabei denselben Instance Key.
Die neue Appliance validiert sich, bindet ihren Fingerabdruck und wird zum aktiven Gerät.

Wenn die alte Hardware defekt oder nicht erreichbar ist

Ist die zuvor gebundene Appliance defekt oder anderweitig nicht erreichbar, läuft der Handshake in einen Timeout und die Cloud-UI zeigt appliance_unreachable_contact_support. Kontaktieren Sie in diesem Fall das IronFlock-Team — wir können die Bindung nach einer Eigentumsprüfung manuell aufheben.

Tipp: Stoßen Sie den Handover an, bevor Sie die alte Hardware ausser Betrieb nehmen, solange sie noch online ist. Der Vorgang ist dann deutlich schneller — für Sie und für unser Support-Team — wenn die alte Appliance noch erreichbar ist.

Lokaler Betrieb

Wenn Sie die Appliance nicht dauerhaft online halten möchten, können Sie jederzeit einen Browser im selben lokalen Netzwerk verwenden und die IP-Adresse oder den Hostnamen der Appliance aufrufen:


http://<appliance-host>

Melden Sie sich mit den Standard-Zugangsdaten an:

Benutzername: admin
Passwort: ironflock

Vergessen Sie nicht, die Admin-Zugangsdaten bei der ersten Anmeldung zu ändern.

App-Web-UIs

Wenn eine App auf einem verbundenen Gerät eine Weboberfläche bereitstellt, macht die Appliance sie über ihren integrierten Tunnel erreichbar. Von Haus aus ist dafür nichts von der Unternehmens-IT nötig — jede App-UI wird über einfaches HTTP auf einem automatisch zugewiesenen Port der Appliance-Adresse veröffentlicht (http://<appliance-host>:<port>), und die IronFlock UI zeigt den Link an. Der Zugriff bleibt weiterhin durch die Appliance-Anmeldung geschützt.

Für vertrauenswürdige https://-URLs in einem gemeinsam genutzten Unternehmensnetzwerk — mit einem Wildcard-Zertifikat Ihrer CA oder einem TLS-terminierenden Reverse-Proxy — siehe App-UIs & HTTPS.

Konten verknüpfen

Legen Sie auf der Appliance lokale Benutzerkonten für Ihr Team an, indem Sie die Teammitglieder in den Projekteinstellungen per E-Mail einladen. Die Einladungs-E-Mail enthält alles, was der Eingeladene benötigt:

Einen persönlichen Verbindungslink — Wird er auf ironflock.com geöffnet, verbindet er das ironflock.com-Konto des Eingeladenen mit der Appliance. Wer noch kein ironflock.com-Konto hat, erstellt zunächst eines — mit der eingeladenen E-Mail-Adresse (die Verbindung wird nur hergestellt, wenn die beiden E-Mail-Adressen übereinstimmen). Sobald die Verbindung besteht, erscheint die Appliance in der Projektauswahl des ironflock.com-Kontos, und der Eingeladene kann sofort remote darauf arbeiten — keine manuellen Schlüssel, keine lokale Registrierung erforderlich.
Einen lokalen Registrierungslink — optional: Wer die lokale Registrierung abschließt, kann sich zusätzlich direkt an der Appliance UI (http://<appliance-host>) anmelden.

Gut zu wissen:

Bestehende lokale Benutzer benötigen keine neue Einladung durch den Projekteigentümer. Sie öffnen auf der Appliance UI ihr Profil und klicken im Abschnitt Mit ironflock.com verbinden auf Verbindungslink per E-Mail senden.
Erneut senden: Wird dieselbe E-Mail-Adresse erneut eingeladen (oder der Button im Profil erneut geklickt), wird ein neuer Verbindungslink ausgestellt. Nur der Link aus der zuletzt versendeten E-Mail ist gültig.
Wenn die Appliance keine E-Mails versenden kann — zum Beispiel in einem eingeschränkten Unternehmensnetzwerk, das das Mail-Relay blockiert — wird der Verbindungslink stattdessen direkt in der UI angezeigt: Der Einladende kopiert ihn und übergibt ihn über einen beliebigen Kanal. Der Link muss in einem Browser mit Internetzugang geöffnet werden.
Verbindung trennen: Ein Benutzer kann die Verbindung jederzeit auf ironflock.com unter Profil → Instanzen → Verbundene Instanzen entfernen. Ein erneutes Öffnen des letzten Verbindungslinks stellt sie wieder her.

Der Instanz-Eigentümer — der Benutzer, der den Instance Key auf ironflock.com erstellt hat — wird automatisch mit dem lokalen Admin-Konto der Instanz verbunden; für den Eigentümer ist keine Einladung erforderlich.

Edge-Geräte hinzufügen

Mit zusätzlichen Edge-Geräten (d. h. Industrie-PCs) können Sie IronFlock-Apps auf weiteren Maschinen bereitstellen und App-Operationen von der Appliance auslagern. Die Appliance selbst dient bereits als Edge-Gerät, Sie können jedoch weitere Edge-Geräte auf die gleiche Weise anbinden, wie Sie es in der IronFlock Cloud tun würden. Gehen Sie dazu einfach zu Projekteinstellungen -> Geräte -> Neues Gerät und folgen Sie den Anweisungen.

Wartung

Um das IronFlock-System auf Ihrer Appliance zu aktualisieren, kann der Admin den Update-Button im Lizenzbereich seines Profils verwenden, sobald eine neue Version verfügbar ist. Die Appliance benötigt eine Internetverbindung, um das Update herunterzuladen. IronFlock startet nach Abschluss des Updates automatisch neu.

Updates des Linux-Betriebssystems liegen in Ihrer eigenen Verantwortung.

Eigener E-Mail-Absender (SMTP)

Standardmäßig werden alle Plattform-E-Mails — Kontoverifizierung, Passwort-Wiederherstellung, Einladungen und Alarmbenachrichtigungen — über den IronFlock-Cloud-SMTP-Proxy weitergeleitet und erscheinen als no-reply@ironflock.com. Damit die E-Mails so aussehen, als kämen sie von Ihrem eigenen Unternehmen, können Sie die Appliance auf Ihren eigenen SMTP-Server umstellen.

Bearbeiten Sie auf dem Appliance-Host die vom Installer erzeugte Umgebungsdatei /opt/ironflock/.env und setzen Sie die folgenden Variablen:


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

Verwenden Sie smtps:// für implizites TLS (typischerweise Port 465) oder smtp:// mit STARTTLS (Port 587).
Sonderzeichen in Benutzername oder Passwort müssen URL-kodiert werden (z. B. @ → %40).
SMTP_FROM_ADDRESS und SMTP_FROM_NAME bestimmen, was Empfänger im Von-Header jeder Plattform-E-Mail sehen.

Übernehmen Sie die Änderung durch einen Neustart des Stacks:


sudo systemctl restart ironflock.service

Nach dem Neustart werden alle Authentifizierungs-E-Mails, Plattformbenachrichtigungen und Alarm-E-Mails über Ihren SMTP-Server mit der Absenderadresse und dem Anzeigenamen Ihres Unternehmens versendet.

Wenn SMTP_CONNECTION_URI nicht gesetzt ist, leitet die Appliance E-Mails weiterhin über den IronFlock-Cloud-SMTP-Proxy weiter, der mit Ihrem Lizenzschlüssel authentifiziert wird — kein zusätzliches Setup erforderlich, die E-Mails tragen jedoch das IronFlock-Branding.

Was in der Box enthalten ist

Die Appliance wird mit allen IronFlock-Diensten vorinstalliert und vorkonfiguriert ausgeliefert:

IronFlock UI erreichbar aus dem lokalen Netzwerk
local App Store für die Offline-Verteilung von Apps
Board Studio, Alarms und Data Store
AI Multi Agent System (funktioniert nur bei bestehender Internetverbindung)

Edge-Gerät und Server in einem

Die Appliance betreibt nicht nur die IronFlock-Plattform — sie kann im IronFlock-Kontext gleichzeitig als Edge-Gerät fungieren. Das bedeutet: Sie kann containerisierte Apps genauso ausführen wie jedes andere verwaltete Gerät und gleichzeitig als zentraler Management-Knoten für weitere Geräte im selben Netzwerk dienen. Dadurch ist sie eine kompakte, vollständige Lösung: Plattform-Server und Edge-Computing in einer einzigen Box.

Da die Appliance denselben IronFlock-Geräteagenten ausführt wie jedes andere verwaltete Edge-Gerät, profitiert sie auch von den Konnektivität & Resilienz-Schutzmechanismen des Agenten — unbegrenzte automatische Netzwerk-Wiederverbindung, dem Speicher-Notfall-Zustand, der die Box erreichbar hält und sich automatisch wiederherstellt, wenn ihre Festplatte voll läuft, dem Out-of-Memory-Schutz und einem sich selbst neu startenden Agenten. Dies ist ein wesentlicher Grund, warum die Appliance — und Ihr Fernzugriff darauf — trotz lokaler Netzwerk-, Festplatten- und Speicherprobleme online bleibt.

Architektur

Hardware

Die Hardware der Appliance ist verhandelbar und wird typischerweise vom OEM oder Maschinenhersteller bereitgestellt. IronFlock liefert den Software-Stack und konfiguriert das System vor der Auslieferung auf der gewählten Hardware vor. In der Regel genügt ein mittelgroßer industrieller Edge-PC (4 Kerne, 8 GB RAM), um den gesamten Stack samt zusätzlichen Anwendungen zu betreiben. Kontaktieren Sie das IronFlock-Team, um die Hardwareanforderungen für Ihren Anwendungsfall zu besprechen.

Apps aus dem Online Store synchronisieren

Die Appliance enthält einen local App Store — einen privaten App-Katalog und eine Container-Registry, die Apps an Geräte im lokalen Netzwerk ausliefert. Sie können diesen lokalen Store befüllen, indem Sie Apps aus dem öffentlichen Online-IronFlock-Store synchronisieren, sofern die Appliance zum Zeitpunkt der Synchronisierung über einen Internetzugang verfügt. Eine dauerhafte Internetverbindung ist nicht erforderlich; eine temporäre Verbindung reicht aus, um die benötigten Apps zu beziehen.

Voraussetzungen

Ein Konto auf der öffentlichen Plattform ironflock.com.
Ihr Appliance-Konto ist mit Ihrem ironflock.com-Konto verbunden (siehe Konten verknüpfen). Das Admin-Konto des Instanz-Eigentümers wird automatisch verbunden.

So funktioniert die App-Synchronisierung


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

Lokalen App Store öffnen — Sobald die Appliance eine aktive Internetverbindung hat, zeigt der App Store alle Apps an, die Ihrem verbundenen ironflock.com-Konto auf der Online-Plattform zur Verfügung stehen.
Benötigte Apps synchronisieren — Statt eines Install-Buttons zeigt jede App einen Sync-Button. Ein Klick darauf lädt die App — inklusive ihrer Container-Images und Metadaten — vom Online Store in den lokalen Store herunter.
Geräte hinzufügen — Nach der Synchronisierung ist die App im lokalen Store vollständig verfügbar, und Sie können Geräte auf gewohnte Weise hinzufügen, ohne dass eine Internetverbindung erforderlich ist.

Update-Workflow

Wenn im Online Store eine neue Version einer synchronisierten App veröffentlicht wird, erscheint für diese App erneut ein Sync-Button. Verbinden Sie die Appliance kurz mit dem Internet, synchronisieren Sie das aktualisierte Release, und rollen Sie es anschließend über den Standard-App-Upgrade-Flow auf Ihre Geräte aus.

Dieses Design gibt Ihnen die volle Kontrolle darüber, was in Ihr Netzwerk gelangt — es wird nichts automatisch heruntergeladen, und die Internetverbindung wird ausschließlich während des Sync-Schritts benötigt.

Einschränkungen

Einzelnes Master-Konto für AppStudio — Die Appliance kann eine AppStudio-Umgebung nur für ein einzelnes Master-Konto hosten. Die App-Entwicklung ist auf eine einzige Organisation beschränkt.
Begrenzte Skalierung — Die Appliance ist für eine begrenzte Anzahl von Maschinen an einem Standort ausgelegt. Flotten, die sich über mehrere Standorte oder Zehntausende von Geräten erstrecken, sind besser mit der Cloud oder einer privaten Cloud-Bereitstellung aufgehoben.
KI-Dienste erfordern ausgehenden LLM-Zugriff — Siehe Private Cloud für Optionen, wenn die Appliance überhaupt keinen Internetzugang hat.

Kontakt

Appliance-Bereitstellungen werden in Zusammenarbeit mit dem IronFlock-Team konfiguriert. Kontaktieren Sie uns, um Hardware, Anzahl der Maschinen und Branding-Anforderungen zu besprechen.