Container¶
Die Seiten unter Container in der Konsole verwalten Docker auf dem Server: die Container, die Fadenstack selbst betreibt, und alle, die Sie daneben hinzufügen, z. B. einen MCP-Server oder einen kleinen Dienst, den Ihre Modelle aufrufen. Die GPU-Maschinen verwalten sie nicht; was dort läuft, verwalten Sie über Cluster und Bereitstellungen.

Die Liste¶
Öffnen Sie Container → Container. Die Liste zeigt jeden Container auf dem Server, auch die von Fadenstack. Die vier Kacheln zählen sie, und jede ist zugleich ein Filter (wählen Sie sie erneut, um wieder alle aufzulisten).
Die Liste Handlungsbedarf im Dashboard meldet Container, die immer wieder neu starten.
Was die Kacheln und die Spalten zeigen
| Kachel | Zählt |
|---|---|
| Läuft | Laufende Container, von allen aufgelisteten |
| Läuft nicht | Beendet, erstellt oder pausiert |
| Fehlerhaft | Laufen, bestehen aber ihren Health-Check nicht |
| Startet neu | Starten neu, oft in einer Absturzschleife |
| Spalte | Was sie zeigt |
|---|---|
| Name | Name und Kurz-ID des Containers |
| Image | Was er ausführt |
| Status | Läuft, beendet oder pausiert, und seit wann |
| Klasse | Was die Konsole mit ihm tun darf (siehe unten) |
| Endpunkt | Der Host-Port, auf dem er veröffentlicht ist, falls vorhanden |
| Bereich | Das Team oder die Einheit, der er gehört |
| Aktionen | Starten, stoppen, pausieren, neu starten, löschen, Details: nur, was seine Klasse erlaubt |
Klassen¶
Die Klasse eines Containers legt fest, was die Konsole mit ihm zulässt, gleich für wen:
| Klasse | Für | Ansehen, Logs | Starten, neu starten | Stoppen | Pausieren, Löschen |
|---|---|---|---|---|---|
SYSTEM_CORE |
Postgres, Redis, der Proxy, RabbitMQ, die Speicher für Logs und Metriken | ja | ja | nein | nein |
SYSTEM_AUX |
Die eigenen Dienste und Module von Fadenstack | ja | ja | ja | nein |
MCP |
MCP-Server | ja | ja | ja | nein |
TENANT_APP |
Container, die Sie betreiben | ja | ja | ja | ja |
UNTRUSTED |
Alles, was nicht klassifiziert ist | ja | nein | nein | nein |
Die Klasse eines Containers ändern Sie in seiner Zeile; SYSTEM_CORE bleibt gesperrt.
Wie ein anderswo erstellter Container seine Klasse erhält
Ein Container, der anderswo erstellt wurde, wird nach seinem Namen klassifiziert, wenn die Liste ihn zum ersten
Mal sieht: Ein Name, der den Namen eines Fadenstack-Dienstes oder der Infrastruktur oben enthält (redis,
postgres usw.), macht ihn zum Systemcontainer, ein Name, der mcp- enthält, zu MCP, alles andere zu
UNTRUSTED.
Der Root-Modus hebt die Grenzen der Klassen für den Administrator auf, der ihn aktiviert, für Wartungsarbeiten am System. Wählen Sie Root-Modus aktivieren und geben Sie eine Begründung und eine Dauer an. Jede Aktion im Root-Modus wird mit hoher Schwere protokolliert.
Mehr zum Root-Modus
Die Begründung braucht mindestens 10 Zeichen; die Dauer beträgt 60 bis 3600 Sekunden. Ein Container, dessen Richtlinie locked ist, lässt sich auch im Root-Modus nicht stoppen, pausieren, bearbeiten oder löschen.
Ein Image holen¶

Ein Container startet aus einem Image auf dem Server; beim Erstellen eines Containers wird das Image nicht heruntergeladen.
- Öffnen Sie Container → Images.
- Geben Sie Name und Tag des Images ein und wählen Sie Image ziehen. Während des Downloads wird der Fortschritt angezeigt.
Dangling-Images bereinigen entfernt Images, auf die kein Tag verweist. Dafür ist der Root-Modus nötig; machen Sie zuerst einen Testlauf.
Einen Container erstellen¶

- Öffnen Sie Container → Container und wählen Sie Erstellen.
- Füllen Sie Image und Containername aus.
- Wählen Sie die Klasse:
TENANT_APPfür einen eigenen Container,MCPfür einen MCP-Server. - Fügen Sie Port-Bindings nur hinzu, wenn etwas außerhalb des Servers den Container erreichen muss.
- Fügen Sie nach Bedarf Umgebungsvariablen und Volume-Mounts hinzu.
- Wählen Sie unter Netzwerke
fadenstack_default, damit das Gateway, die Konsolen-API und der MCP-Dienst den Container unter seinem Namen erreichen (z. B.http://my-service:8080). - Schalten Sie Sofort nach Erstellung starten ein und wählen Sie Erstellen und starten, oder lassen Sie es aus und wählen Sie Container erstellen, um den Container gestoppt anzulegen.
Mehr zu den Feldern
- Image: Die Vorschläge kommen aus den Images auf dem Server.
- Befehl überschreiben ist optional, geschrieben wie in einer Shell.
- Richtlinie und Bereich: Setzen Sie sie, wenn Sie diese verwenden.
- Port-Bindings: Die Dienste von Fadenstack erreichen den Container auch ohne über sein Netzwerk unter seinem Namen. Ein Host-Port muss auf dem Server frei sein.
- Netzwerke: Ohne Netzwerk kommt der Container in die Standard-Bridge von Docker.
Hinweis
Die Konsole verbirgt Werte, die geheim aussehen: Variablen, deren Name auf Passwort, Schlüssel, Token oder
Geheimnis lautet, das Passwort in einer URL und den Wert nach einem Schalter wie --requirepass. Das
Bearbeitungsformular zeigt sie als Punkte; unverändert bleiben sie erhalten. Jeder Blick auf die Details oder
Einstellungen eines Systemcontainers wird im Audit-Protokoll festgehalten. Werte, die die Konsole nicht als
geheim erkennt, werden angezeigt; benennen Sie Geheimnisse daher als solche.
Container erstellen, bearbeiten und neu klassifizieren kann nur ein Superuser. Ein Container, der Root-Rechte auf dem
Server hätte, braucht den Root-Modus: einer, der einen Ordner oder eine Datei des Servers einbindet (einen
Host-Pfad wie /srv/data, ./config oder C:\data; darunter auch den Docker-Socket, / und Systemordner wie
/etc), oder der das Netzwerk host oder das Netzwerk eines anderen Containers nutzt. Ohne Root-Modus lehnt die
Konsole ihn ab und sagt, warum. Geben Sie unter Volume-Mounts statt eines Host-Pfads einen Namen an (my-data,
nicht /data/app): Docker legt dann ein benanntes Volume für den Container an, und das braucht keinen Root-Modus.
Ausgenommen sind die eigenen Volumes von Fadenstack: Die Dateien der Datenbank, die Chat-Dateien, das Audit-Protokoll
und die Modelle (fadenstack_pg_data, fadenstack_faden_chat_files und die übrigen, die seine Container nutzen)
werden nur im Root-Modus eingebunden, und das Audit-Protokoll hält fest, welche Volumes ein Container bekam. Ohne
Root-Modus darf nur die Zeitzone schreibgeschützt eingebunden werden (/etc/localtime, /etc/timezone,
/usr/share/zoneinfo, mit :ro).
Mehr dazu, was den Root-Modus braucht
- Bearbeiten: Die eigenen Container von Fadenstack (
SYSTEM_COREundSYSTEM_AUX) werden nur im Root-Modus bearbeitet: Ein neues Image oder eine neue Umgebung für das Gateway läse mit dessen Schlüssel jeden Chat. Ihre Schaltfläche Bearbeiten ist ausgegraut, bis der Root-Modus aktiv ist. - Der neue Container behält, was das Formular nicht zeigt. Deshalb braucht eine Bearbeitung den Root-Modus auch, wenn der Container privilegiert läuft, die Prozesse oder den Speicher des Servers teilt, dessen Geräte nutzt (GPUs ausgenommen), die Volumes eines anderen Containers übernimmt oder eines der eigenen Volumes von Fadenstack einbindet.
- Klasse: Die Klasse eines Containers mit einem der genannten Punkte oder eines
SYSTEM_CORE- oderSYSTEM_AUX-Containers zu ändern, braucht den Root-Modus; ebenso das Entsperren eines gesperrten Systemcontainers. - Starten, Stoppen und Neustarten brauchen keinen Root-Modus: Sie führen im Container nichts Neues aus.
Mit einem Container arbeiten¶

Seine Seite hat zwei Tabs:
| Tab | Was er tut |
|---|---|
| Übersicht | Status, Image, Netzwerke |
| Logs | Letzte 300 Zeilen, zum Aktualisieren oder Herunterladen |
Stoppen Sie einen Container, bevor Sie ihn löschen: Ein laufender Container wird nicht gelöscht. Vor dem Löschen fragt die Konsole nach einer Bestätigung; das Image bleibt unter Images erhalten.
Wenn ein Container nicht stoppt
Ein Prozess, der das Stoppsignal ignoriert, wird nach zehn Sekunden zwangsweise beendet und erscheint als
Exited (137).
Einen Container bearbeiten¶

- Wählen Sie auf der Seite des Containers Bearbeiten. Das Formular öffnet sich mit den Einstellungen, mit denen der Container erstellt wurde.
- Ändern Sie, was nötig ist, und wählen Sie Speichern und ersetzen.
- Bestätigen Sie.
Docker kann diese Einstellungen an einem bestehenden Container nicht ändern; deshalb ersetzt Speichern und ersetzen ihn: Ein neuer Container wird mit den neuen Einstellungen erstellt, in denselben Netzwerken und unter demselben Namen, und der alte Container wird entfernt, sobald der neue läuft.
Achtung
Der Container erhält eine neue ID, und Dateien, die er außerhalb seiner Volumes geschrieben hat, gehen verloren.
Mehr zum Ersetzen eines Containers
- Was das Formular nicht zeigt, bleibt erhalten: GPU-Geräte, Neustartrichtlinie, Labels, Health-Check.
- Kann der neue nicht erstellt oder gestartet werden (ein Image, das nicht auf dem Server liegt, ein belegter Host-Port), wird der alte wiederhergestellt, wie er war, und die Seite nennt den Grund.

Auch die eigenen Container von Fadenstack lassen sich bearbeiten, für einen Test oder eine schnelle Korrektur. Das
nächste faden deploy oder faden upgrade erstellt sie aber aus der Compose-Datei und .env neu, ohne Ihre
Änderungen; das Formular weist darauf hin. Den Container der Konsolen-API selbst können Sie nicht aus der Konsole
bearbeiten: Ändern Sie seine Einstellungen in ~/fadenstack/.env und führen Sie faden upgrade (oder faden up)
aus.
Netzwerke und Stacks¶
Container → Netzwerke listet die Netzwerke von Docker. fadenstack_default ist das eigene Netzwerk von
Fadenstack; Systemnetzwerke sind schreibgeschützt. Sie können ein Netzwerk erstellen (wahlweise intern, ohne
Zugang nach außen), eines untersuchen und die von Ihnen erstellten löschen.
Container → Stacks bewahrt Docker-Compose-Dateien unter einer ID auf. Stack deployen speichert eine; ein
erneutes Speichern unter derselben ID erzeugt eine neue Revision. Jede Revision bleibt erhalten, zwei lassen sich
vergleichen, und Sie können zu einer früheren zurückkehren. Trotz seines Namens startet Stack deployen die
Container nicht, die eine Datei beschreibt: Führen Sie sie selbst mit docker compose auf dem Server aus.
Siehe auch¶
- MCP-Server: Ein MCP-Server kann hier als Container laufen und unter seinem Namen im Netzwerk registriert werden.