Betrieb

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 als Admin-Benutzer an:

Benutzername: admin
Passwort: das initiale Admin-Passwort, das für Ihre Appliance generiert wurde

Der Installer gibt dieses Passwort am Ende der Installation aus. Außerdem ist es als APPLIANCE_ADMIN_PASSWORD in /opt/ironflock/.env auf dem Appliance-Host gespeichert, einer Datei, die nur root lesen kann:


sudo grep '^APPLIANCE_ADMIN_PASSWORD=' /opt/ironflock/.env

Ändern Sie das Passwort nach Ihrer ersten Anmeldung.

Admin-Passwort vergessen? Führen Sie dies auf dem Appliance-Host aus, um ein neues zu setzen; der Befehl gibt das neue Passwort aus:


curl -fsSL https://instance-registry.ironflock.com/dl/appliance/install_ironflock.sh \
  | sudo bash -s -- --reset-admin-password

Ältere Appliances: Eine Appliance, die installiert wurde, bevor der Installer das Admin-Passwort generiert hat, startet mit dem Passwort ironflock. Bei der ersten Anmeldung damit werden Sie aufgefordert, ein neues Passwort festzulegen.

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.

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.

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 [email protected]. 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:[email protected]:465/
SMTP_FROM_ADDRESS=[email protected]
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.

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.

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 Installation 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.