Skip to Content

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

ironflock appliance install zeigt dieses Passwort am Ende der Installation einmal im Terminal an. 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:

sudo ironflock appliance reset-admin-password

Die Appliance muss laufen. Der Befehl setzt das neue Passwort und beendet jede aktive Sitzung des Admins. Er zeigt das neue Passwort einmal an, und nur in einem Terminal; ohne Terminal oder mit --json sagt er stattdessen, wo das Passwort gespeichert ist. Siehe ironflock appliance reset-admin-password.

Ältere Appliances: Eine Appliance, die installiert wurde, bevor die Installation 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
  1. 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.
  2. 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.
  3. 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 Umgebungsdatei der Appliance, /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 der Appliance:

sudo ironflock appliance restart

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. Auf dem Appliance-Host läuft dasselbe Update mit:

sudo ironflock appliance update

Die Appliance benötigt eine Internetverbindung, um das Update herunterzuladen. IronFlock startet nach Abschluss des Updates automatisch neu. Die Appliance installiert ein Update nur mit einer gültigen Signatur von IronFlock, und wenn ein Update fehlschlägt, kehrt sie zu der Version zurück, mit der sie vorher lief (siehe Updates und ironflock appliance update).

Auch der Update-Button führt das ironflock in /usr/local/bin auf dem Appliance-Host aus. Braucht ein Release ein neueres ironflock, installiert das Update es zuerst, mit den Prüfungen von ironflock self-update, und macht damit weiter (Ein neueres ironflock). Ein ironflock von Release 2.2.0 oder älter kann das nicht: Führen Sie einmal die Installationszeile aus, um es auf das aktuelle Release zu bringen (Von 2.2.0 und älter).

Updates des Linux-Betriebssystems liegen in Ihrer eigenen Verantwortung.

Cloud-Verbindung

Die Appliance hält eine ausgehende Verbindung zu ironflock.com. Über sie arbeiten Sie von ironflock.com aus auf der Instanz (siehe Auf Ihre Instanz über ironflock.com zugreifen), öffnen App-Oberflächen und Dateien aus der Ferne und starten Updates sowie den Handover der Lizenz aus der Cloud. Soll die Appliance von ironflock.com aus nicht erreichbar sein, schalten Sie diese Verbindung aus.

Solange die Cloud-Verbindung ausgeschaltet ist:

  • Die Appliance ist von ironflock.com aus nicht erreichbar. Die Instanzliste auf ironflock.com zeigt sie als Cloud-Verbindung aus an.
  • Der Remote-Zugriff auf App-Oberflächen und Dateien über ironflock.com endet.
  • Appliance-Updates und der Handover der Lizenz lassen sich nicht aus der Cloud starten. Der Admin kann die Appliance weiterhin lokal aktualisieren (siehe Wartung).
  • Nutzungsberichte bleiben auf der Appliance und werden gesendet, sobald die Verbindung wieder eingeschaltet ist.
  • Geräte, der lokale Betrieb, die Synchronisierung von Apps aus dem Online Store und die Lizenzvalidierung funktionieren weiter.

Die Einstellung bleibt über Neustarts und Appliance-Updates hinweg erhalten.

Ein- und Ausschalten auf der Appliance

Der Admin schaltet die Cloud-Verbindung im Abschnitt Cloud-Verbindung des Lizenzbereichs seines Profils auf der Appliance UI (http://<appliance-host>) ein und aus. Nur das Admin-Konto kann sie schalten, und nur lokal — nicht, während auf der Instanz über ironflock.com gearbeitet wird.

Über ironflock.com ausschalten

Der Eigentümer der Instanz — das ironflock.com-Konto, das den Instance Key erstellt hat — kann die Cloud-Verbindung aus der Cloud ausschalten: Öffnen Sie Profil → Instanzen auf ironflock.com und klicken Sie bei der Instanz auf Cloud-Verbindung ausschalten. Die Appliance muss online sein.

Dies lässt sich aus der Cloud nicht rückgängig machen. Nur der Admin der Appliance kann die Verbindung wieder einschalten, lokal auf der Appliance.

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:

  1. Öffnen Sie Profil → Instanzen auf ironflock.com.
  2. 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 und ihre Cloud-Verbindung eingeschaltet 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:

  1. Richten Sie die neue Hardware gemäß den Schritten unter Installation ein und verwenden Sie dabei denselben Instance Key.
  2. 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.

Last updated on