> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/de/tenants/tenant-crash-cart-guide.md).

# Leitfaden für den Tenant Crash Cart

## Überblick

Der **Mandanten-Crash-Cart** ist eine virtuelle Hilfsmaschine, die dafür ausgelegt ist, im Notfall Zugriff auf die VergeOS-Umgebung eines Mandanten zu ermöglichen, wenn das externe Netzwerk des Mandanten falsch konfiguriert ist oder anderweitig nicht erreichbar ist. Durch die direkte Verbindung mit dem Kernnetzwerk des Mandanten können Administratoren des übergeordneten Systems sich selbst dann an der Mandanten-UI anmelden, wenn normale Zugriffswege nicht verfügbar sind.

Dieses Tool ist besonders nützlich in Wiederherstellungsszenarien, in denen Mandanten-Betreiber ihre eigene UI aufgrund von Netzwerkproblemen, falsch konfigurierten Firewalls oder falschen externen IP-Einstellungen nicht erreichen können.

## Wann ein Crash Cart verwendet werden sollte

Ein Crash Cart ist geeignet, wenn:

* Die Mandanten-UI ist über die normale externe URL nicht erreichbar.
* Externe Netzwerkeinstellungen wurden falsch konfiguriert und müssen korrigiert werden.
* Firewall-Regeln wurden so geändert, dass der Zugriff auf die UI blockiert wird.
* Das externe Netzwerk des Mandanten ist ausgeschaltet oder funktioniert nicht wie erwartet.
* Sie benötigen einen direkten internen Pfad in die Mandanten-Umgebung zur Fehlerbehebung.

## Wichtige Merkmale

* Verfügbar als **Rezept** im Marketplace.
* Bietet einen Verbindungspfad vom **übergeordneten System** zum Mandanten.
* Umgeht nicht **nicht** die Mandanten-Authentifizierung — gültige Mandanten-Administrator-Anmeldedaten sind weiterhin erforderlich.
* Enthält keine speziellen Werkzeuge; sein Zweck besteht darin, die Mandanten-UI intern bereitzustellen.

***

## Voraussetzungen

* Berechtigungen zum Erstellen/Starten von VMs und der vorgesehene Mandant auf dem übergeordneten System
* Zugriff auf die **Dienste (Marketplace)** Katalog.
* Administrator-Anmeldedaten des Mandanten, den Sie reparieren möchten.
* Grundlegendes Verständnis des Mandantennetzwerks und der Konfiguration externer Netzwerke.

***

## Bereitstellen eines Mandanten-Crash-Carts

### 1. Erstellen Sie die Crash-Cart-VM

1. Navigieren Sie zu **Mandanten** und wählen Sie den Mandanten aus, der wiederhergestellt werden muss.
2. Im **Mandantennetzwerk** Abschnitt finden Sie das **Crash-Cart** Feld und klicken Sie auf **-- ERSTELLEN --**.
3. Geben Sie einen **Name** für die VM.
4. Wählen Sie einen **Cluster** (oder lassen Sie den Standardwert).
5. Klicken Sie **Absenden** um die VM-Instanz zu erstellen.

Die VM wird erstellt und automatisch mit dem Kernnetzwerk des Mandanten verbunden.

{% hint style="success" %}
**Alternative: Aus dem Marketplace erstellen**

Sie können einen Crash Cart auch aus **Virtuelle Maschinen** > **+ Neue VM**. Unter **Kataloge**, wählen Sie **Dienste (Marketplace)**, wählen Sie **Mandanten-Crash-Cart**, und klicken Sie dann auf **Weiter**. Geben Sie dort einen Namen an, wählen Sie einen Cluster aus und wählen Sie den Mandanten aus, mit dem verbunden werden soll.
{% endhint %}

***

### 2. Die Crash-Cart-Konsole einschalten und aufrufen

1. Klicken Sie im VM-Dashboard auf **Einschalten**.
2. Öffnen Sie die Konsole mit **Remote-Konsole** oder der Konsolenschaltfläche oben links.
3. Melden Sie sich an der OS-Shell mit dem Benutzernamen und Passwort an, die in der **Hinweis** Abschnitt.

{% hint style="success" %}
**Beim Start meldet sich die VM möglicherweise automatisch an der OS-Shell an. Der Crash Cart meldet sich niemals automatisch an der VergeOS-UI an.**
{% endhint %}

***

### 3. Melden Sie sich an der VergeOS-UI des Mandanten an

Sobald die VM startet, zeigt sie eine Browser-Sitzung an, die auf die VergeOS-UI des Mandanten ausgerichtet ist.

1. Geben Sie Ihre **Administrator-Anmeldedaten des Mandanten**.
2. Führen Sie die erforderlichen Reparaturen an der Konfiguration des externen Netzwerks des Mandanten durch.

Der Crash Cart bietet internen Zugriff, selbst wenn das externe Netzwerk des Mandanten nicht erreichbar ist.

***

## Häufige Fehlerszenarien

Der Crash Cart ist das richtige Werkzeug zur Behebung von Problemen wie:

* Falsch aktualisierte Mandanten-URL oder externe IP-Adresse
* Firewall-Regeln blockieren den Zugriff auf die UI (z. B. sind die Ports 80/443 deaktiviert)
* Externes Netzwerk ist ausgeschaltet und startet nicht automatisch neu
* Andere Probleme mit dem externen Netzwerk des Mandanten, die eine normale UI-Konnektivität verhindern

***

## Bewährte Verfahren

* **Halten Sie eine Crash-Cart-VM für die Wiederverwendung ausgeschaltet** um Verzögerungen bei dringenden Wiederherstellungen zu vermeiden.
* Bei Wiederverwendung:
  * Schalten Sie die VM aus.
  * Bearbeiten Sie die Rezeptinstanz der VM, um sie auf **--Keine--** zu setzen, um sie zu trennen.
  * Wenn sie wieder benötigt wird, bearbeiten Sie die Rezeptinstanz, um den gewünschten Mandanten auszuwählen, und schalten Sie sie ein.

***

## Aufräum- und Wiederverwendungsoptionen

Nach Abschluss der Reparaturen können Sie:

### Empfohlen: Die VM für die zukünftige Verwendung behalten

* Schalten Sie die Crash-Cart-VM aus.
* Wählen Sie **Rezeptinstanz bearbeiten** im linken Menü; unter **Wählen Sie den Mandanten aus, mit dem verbunden werden soll**, wählen Sie ***--Keine--***; **Absenden** um die Änderung zu speichern.
* Lassen Sie die VM für eine schnelle erneute Bereitstellung verfügbar.
* Weisen Sie sie später durch Bearbeiten der Rezeptinstanz einem anderen Mandanten zu.

### Alternative: Die VM löschen

* Wenn Sie eine saubere Umgebung bevorzugen, können Sie die VM vollständig löschen.
* Das Rezept bleibt weiterhin verfügbar im *Marketplace* um bei künftigem Bedarf eine neue Instanz zu erstellen.

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/de/tenants/tenant-crash-cart-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
