> 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/learn-the-platform/de/modul-7-multi-tenancy/02-creating-tenants.md).
# Mandanten erstellen und konfigurieren
## Methoden zur Mandantenerstellung
VergeOS bietet drei Methoden zum Erstellen neuer Mandanten, jede für unterschiedliche Szenarien geeignet:
```mermaid
flowchart LR
START["Mandanten erstellen"] --> W["Assistent"]
START --> C["Klonen"]
START --> R["Rezept"]
W --> WD["Benutzerdefinierte Konfiguration
Schritt-für-Schritt-Formulare"]
C --> CD["Vorhandenen
Mandanten als Vorlage duplizieren"]
R --> RD["Automatisierte Bereitstellung
aus vordefinierter Vorlage"]
style W fill:#e3f2fd,stroke:#1565c0
style C fill:#fff3e0,stroke:#e65100
style R fill:#e8f5e9,stroke:#2e7d32
```
| Methode | Am besten geeignet für | Wichtige Merkmale |
| ------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| **Assistent** | Einmalige oder einzigartige Mandanten | Schritt-für-Schritt-Formulare für Einstellungen, Knoten, Speicher und UI-Verwaltung |
| **Klon** | Duplizieren eines vorhandenen Mandanten | Erstellt eine Kopie eines laufenden oder gestoppten Mandanten für Tests, Entwicklung oder schnelle Bereitstellung |
| **Rezept** | Standardisierte, wiederholbare Bereitstellungen | Automatisierte Bereitstellung aus einer vordefinierten Vorlage mit anpassbaren Eingabefeldern |
Alle drei Methoden werden vom selben Ausgangspunkt aus aufgerufen: **Mandanten > + Neuer Mandant** in der VergeOS-Oberfläche.
## Durchlauf des Mandanten-Assistenten
Der Mandanten-Assistent führt Sie durch mehrere Eingabeformulare, um einen vollständig benutzerdefinierten Mandanten zu erstellen. Dies ist die gängigste Methode, um Ihre ersten Mandanten zu erstellen oder Einmalumgebungen aufzubauen.
### Schritt 1: Formular „Mandanteneinstellungen“
1. Navigieren Sie zu **Mandanten** über das obere Menü
2. Klicken Sie auf **+ Neuer Mandant**
3. Wählen Sie **Aus dem Assistenten** oben links und klicken Sie dann auf **Weiter**
Das Formular „Mandanteneinstellungen“ enthält die folgenden Felder:
| Feld | Beschreibung | Erforderlich |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
| **Namen** | Anzeigename für den Mandanten | Ja |
| **URL** | Link zur Mandanten-UI -- wird automatisch ausgefüllt, wenn die erste externe IP zugewiesen wird | Nein |
| **Passwort für den Administratorbenutzer** | Passwort für den automatisch erstellten Root-Benutzer „admin“ | Ja |
| **Passwort des Administratorbenutzers bestätigen** | Geben Sie das Admin-Passwort erneut ein, um zu bestätigen, dass es übereinstimmt | Ja |
| **Passwortänderung erzwingen** | Erzwingt, dass der Mandantenadministrator das Passwort bei der ersten Anmeldung ändert | Nein |
| **Beschreibung** | Zusätzliche Notizen oder Metadaten zum Mandanten | Nein |
| **Systemsnapshots anzeigen** | Ermöglicht dem Mandanten, Snapshots des übergeordneten Systems zu durchsuchen und seinen eigenen Mandanten-Snapshot selbstständig aus den Snapshot-Zeitpunkten des Anbieters herunterzuladen (standardmäßig aktiviert) | Nein |
| **Themenzugriff** | Steuert, ob der Mandant eigene Themes erstellen und/oder auf Host-Themes zugreifen kann | Nein |
| **Benutzerdefinierte Hilfe-URL** | Leitet Mandanten-Hilfe-Links auf eine alternative Dokumentationsseite um | Nein |
| **OIDC-Anwendung** | Definiert eine Autorisierungsquelle für den Mandanten (aus vom übergeordneten System definierten OIDC-Apps) | Nein |
Das **Themenzugriff** Optionen steuern die Branding-Funktionen:
* **Kann keine neuen Themes erstellen, nur Lesezugriff auf alle Host-Themes** -- Mandant kann Host-Themes verwenden, aber nicht ändern
* **Kann keine neuen Themes erstellen, nur Lesezugriff auf die angegebenen Host-Themes** -- Mandant kann nur ausgewählte Themes sehen
* **Kann neue Themes erstellen, kein Zugriff auf Host-Themes** -- Mandant erstellt sein eigenes Branding von Grund auf
* **Kann neue Themes erstellen, nur Lesezugriff auf Host-Themes** -- volle Flexibilität unter Verwendung von Host-Themes als Referenz
### Schritt 2: Formular für neuen Mandantenknoten
Dieses Formular konfiguriert den initialen Mandantenknoten. Weitere Mandantenknoten können nach Abschluss des Assistenten hinzugefügt werden.
| Feld | Beschreibung | Hinweise |
| ---------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| **Kerne** | Anzahl der dem Mandantenknoten zugewiesenen CPU-Kerne | Größe basierend auf den erwarteten Workloads |
| **RAM** | Menge an dem Mandantenknoten zugewiesenem Arbeitsspeicher | Größe basierend auf den erwarteten Workloads |
| **Cluster** | Physischer Cluster, auf dem der Mandantenknoten ausgeführt wird | Bei --Standard-- belassen, sofern kein bestimmter Cluster vorgesehen ist |
| **Failover-Cluster** | Zu verwendender Cluster, wenn der primäre nicht verfügbar ist | Für Standardbereitstellungen bei --Standard-- belassen |
| **Bevorzugter Knoten** | Den Mandantenknoten an einen bestimmten physischen Knoten binden | **Nicht empfohlen** -- kann sich negativ auf die Redundanz auswirken |
| **Bei Stromausfall** | Verhalten, wenn das Hostsystem nach einem Stromausfall wiederhergestellt wird | **Letzter Zustand** (Standard), **Aus lassen**, oder **Einschalten** |
{% hint style="warning" %}
Das Festlegen eines **Bevorzugter Knoten** ist eine erweiterte Konfiguration, die die integrierte HA-Redundanz beeinträchtigen kann. Wenden Sie sich vor der Verwendung dieser Option an den VergeOS-Support.
{% endhint %}
### Schritt 3: Formular für neuen Mandantenspeicher
| Feld | Beschreibung |
| --------------------- | ------------------------------------------------------------------------------------- |
| **Tier** | Welche vSAN-Speicherebene für das Speicher-Volume des Mandanten verwendet werden soll |
| **Speicherkapazität** | Bereitzustellende Speichermenge für den Mandanten |
Der Mandant erhält ein dediziertes Speicher-Volume aus der ausgewählten Ebene. Dieses Volume bietet eine exklusive Speicherisolierung -- Mandantendaten sind auf Volume-Ebene vollständig voneinander getrennt.
### Schritt 4: Formular zur UI-Verwaltung
Im letzten Schritt wird dem Mandanten optional eine externe IP-Adresse zugewiesen, wodurch der Zugriff auf die Verwaltungs-UI des Mandanten ermöglicht wird.
1. Wählen Sie eine IP aus dem **Externe IP zuweisen** Dropdown (listet alle nicht zugewiesenen virtuellen IPs im übergeordneten System auf)
2. Wenn keine geeignete IP vorhanden ist, klicken Sie auf **Neue externe IP erstellen** um eine zu definieren:
* **Netzwerk** -- wählen Sie das passende externe Netzwerk aus
* **Typ** -- Virtuelle IP
* **IP-Adresse** -- Adresse eingeben oder leer lassen, um automatisch die nächste verfügbare zuzuweisen
* **Besitzer** -- Name des neuen Mandanten
3. Klicken Sie auf **Senden** um die Mandantenerstellung abzuschließen
Wenn ein Mandant **Proxy** konfiguriert ist, bietet das Formular zur UI-Verwaltung außerdem eine **Neue FQDN erstellen** Option anstelle der Zuweisung einer externen IP. Wenn Sie sie auswählen, wird eine **Proxy-Mandantenkonfiguration** Seite geöffnet, auf der Sie das Netzwerk des Proxys, den Mandanten und den FQDN wählen (den A-Record, der auf den IP-Alias des Proxys zeigt); klicken Sie dann auf **Überspringen** unten auf der Seite „UI-Verwaltung“, um keine direkte IP zuzuweisen. Ein Mandant kann nicht gleichzeitig eine UI-IP-Adresse und einen per Proxy bereitgestellten FQDN haben.
{% hint style="success" %}
Eine „externe IP“ ist jede Adresse außerhalb des VergeOS-Systems -- sie kann eine öffentliche Internetadresse oder eine private Adresse in Ihrem externen LAN/WAN sein (z. B., `10.10.10.100`).
{% endhint %}
Nach der Erstellung wird das Mandanten-Dashboard angezeigt. Klicken Sie auf **Einschalten** im linken Menü, um den Mandanten zu starten. Wenn externe IPs zugewiesen wurden, klicken Sie auf die orange **Regeln anwenden erforderlich** Meldung, um die erforderlichen Netzwerkregeln anzuwenden.
## Mandantenklonen
Beim Klonen wird ein Duplikat eines vorhandenen Mandanten erstellt, was es nützlich für Tests, Entwicklung, Wiederherstellungen und schnelle Bereitstellungsszenarien macht.
### Klon-Kurzanleitung
1. Navigieren Sie zu **Mandanten > + Neuer Mandant**
2. Wählen Sie **Vorhandenen klonen** oben links
3. Wählen Sie den Quellmandanten aus der **Verfügbare Auswahlen** Liste aus und klicken Sie dann auf **Weiter**
4. Ändern Sie die **Namen** nach Bedarf (Standardwert: `-Klon`)
5. Optional auswählen **Als neuen Mandanten klonen** um Verlauf, Statistiken, Protokolle und ablaufende Snapshots aus dem Klon zu entfernen
6. Klicken Sie auf **Senden**
Der geklonte Mandant erscheint in seinem eigenen Dashboard und ist bereit zum Einschalten.
### Überlegungen zum Klonen
{% hint style="warning" %}
Beim Klonen von Mandanten sollten Sie mögliche Konflikte beachten:
* **MAC-Adressen** -- geklonte VMs erhalten dieselben MAC-Adressen wie das Original. Wenn beide im selben Layer-2-Netzwerk laufen, kommt es zu Konflikten
* **IP-Adressen** -- statische IP-Konfigurationen werden dupliziert, was zu Konflikten führt, wenn beide Mandanten dasselbe externe Netzwerk nutzen
* **Anwendungsinstanzen** -- Dienste wie Active Directory, DNS oder DHCP können in Konflikt geraten, wenn Original und Klon gleichzeitig aktiv sind
Das **Als neuen Mandanten klonen** Die Option wird empfohlen, wenn Verlauf und Protokolle des Quellmandanten nicht benötigt werden, da sie einen saubereren Ausgangspunkt schafft.
{% endhint %}
## Mandantenänderungen
Nachdem ein Mandant erstellt wurde, kann seine Konfiguration über das Mandanten-Dashboard geändert werden:
* **Mandantenknoten hinzufügen** -- Rechenleistung skalieren, indem weitere Mandantenknoten mit eigenen Kern-/RAM-Zuweisungen hinzugefügt werden
* **Speicher anpassen** -- die Speicherzuweisung des Mandanten erhöhen (oder verringern)
* **Einstellungen ändern** -- den Mandantennamen, die Beschreibung, das Admin-Passwort, den Themenzugriff, die OIDC-Konfiguration und andere Einstellungen ändern
* **Netzwerke verwalten** -- zusätzliche interne Netzwerke erstellen, Firewall-Regeln anpassen und Routing innerhalb des Mandanten konfigurieren
Alle Änderungen werden entweder aus der Sicht des übergeordneten Systems im Mandanten-Dashboard oder innerhalb der eigenen Verwaltungs-UI des Mandanten vorgenommen.
## Zuweisen externer IP-Adressen
Externe IP-Adressen bieten Mandanten Konnektivität zu Netzwerken außerhalb des VergeOS-Systems -- sei es das öffentliche Internet oder ein privates WAN/LAN. Wenn eine externe IP zugewiesen wird, werden die entsprechenden Routing-Regeln automatisch erstellt.
### Zuweisen einer einzelnen IP
**Vom Host-/übergeordneten System aus:**
1. Navigieren Sie zu **Netzwerke > Extern** (Ihr externes Root-Netzwerk)
2. Klicken Sie auf **IP-Adressen** im linken Menü
3. Klicken Sie auf **Neu** und konfigurieren Sie:
* **Typ:** Virtuelle IP
* **IP-Adresse:** Geben Sie die externe Adresse ein (z. B., `203.0.113.50`)
* **Besitzertyp:** Mandant
* **Besitzer:** Wählen Sie den Zielmandanten aus
4. Klicken Sie auf **Senden**
5. Kehren Sie zum Dashboard des externen Netzwerks zurück und klicken Sie auf **Regeln anwenden**
**Innerhalb des Mandanten:**
1. Melden Sie sich in der Mandanten-UI an
2. Navigieren Sie zu **Netzwerke > Extern**
3. Die zugewiesene IP erscheint in der **IP-Adressen** Liste mit der Beschreibung „Externe IP vom Dienstanbieter“
4. Klicken Sie auf **Regeln anwenden** im externen Netzwerk des Mandanten
### Verwendung von Netzwerkblöcken
Für Mandanten, die mehrere externe IPs benötigen, **Netzwerkblöcke** weisen Sie eine Gruppe von IPs als eine Einheit zu:
1. Navigieren Sie zum Root- **Externe** Netzwerk
2. Klicken Sie auf **Netzwerkblöcke** im linken Menü
3. Klicken Sie auf **Neu** und geben Sie den Block im CIDR-Format ein (z. B., `203.0.113.48/29`)
4. Setzen Sie **Besitzertyp** auf Mandant setzen und den Mandanten auswählen
5. Klicken Sie auf **Senden**
{% hint style="info" %}
Netzwerkblöcke erfordern mindestens 4 IPs (/30), um 1 nutzbare Adresse bereitzustellen, da der Block den Aufwand für Netzwerkadresse, Gateway und Broadcast-Adresse enthält. Ein /29-Block (8 IPs) bietet 5 nutzbare Adressen.
{% endhint %}
## Dateien mit Mandanten teilen
Dienstanbieter können Dateien (ISO-Images, Mediendateien, Disk-Images) vom übergeordneten System direkt in den **Dateien** Bereich eines Mandanten teilen. Dabei wird eine effiziente Branch-Operation auf dem vSAN verwendet, wodurch der Vorgang unabhängig von der Dateigröße nahezu sofort erfolgt.
### Eine Datei teilen
1. Navigieren Sie zu **Mandanten > Liste** und doppelklicken Sie auf den Zielmandanten
2. Klicken Sie auf **Datei hinzufügen** im linken Menü
3. Wählen Sie den **Dateityp** aus dem Dropdown aus (oder wählen Sie **ALLE** um jede verfügbare Datei anzuzeigen, einschließlich `.raw` Disk-Images)
4. Wählen Sie die gewünschte Datei aus dem Dropdown aus
5. Klicken Sie auf **Senden**
Die Datei ist sofort im **Dateien** Bereich des Mandanten verfügbar. Da dieser Vorgang einen vSAN-Branch verwendet (ähnlich wie eine Snapshot-Referenz), werden die Daten auf der Festplatte nicht dupliziert -- dem Mandanten wird lediglich eine Referenz auf die vorhandenen Blöcke bereitgestellt.
## Teilen von VM-Snapshots
Das **Freigegebene Objekte** Funktion ermöglicht das auf Snapshots basierende Teilen von VMs zwischen einem Anbieter und einem Mandanten (oder umgekehrt). Beide Seiten können der anderen einen bestimmten VM-Snapshot zur Verfügung stellen, um innerhalb ihres eigenen Systems eine neue VM zu erstellen.
### Vom sendenden System aus
1. Navigieren Sie zum VM-Dashboard der VM, die Sie teilen möchten
2. Fahren Sie die VM ordnungsgemäß herunter (bewährte Praxis)
3. Erweitern **Snapshots** im linken Menü und klicken Sie auf **Snapshot erstellen**
4. Geben Sie einen **Namen** und **Ablaufdatum**, und klicken Sie dann auf **Senden**
5. Navigieren Sie zu **System > Freigegebene Objekte**
6. Klicken Sie auf **Neu** und konfigurieren Sie:
* **Namen** -- Kennung für das freigegebene Objekt (wird zum Namen der importierten VM)
* **Typ** -- Virtuelle Maschine
* **Snapshot** -- wählen Sie den erstellten VM-Snapshot aus
* **Empfänger** -- wählen Sie den Zielmandanten (oder Dienstanbieter) aus
7. Klicken Sie auf **Senden**
### Vom empfangenden System aus
1. Navigieren Sie zu **System > Freigegebene Objekte**
2. Eingehende freigegebene Objekte erscheinen in der Liste
3. Wählen Sie die gewünschte VM aus und klicken Sie auf **Importieren**
4. Optional das Häkchen bei **MAC-Adressen beibehalten** entfernen, wenn die Quell-VM aktiv bleibt (verhindert MAC-Konflikte)
5. Optional einen **Bevorzugte Ebene** für die Laufwerke der neuen VM auswählen
6. Klicken Sie auf **Senden** um den Import abzuschließen
Die importierte VM erscheint in der VM-Liste des Mandanten und ist bereit zur Konfiguration und zum Einschalten.
```mermaid
sequenceDiagram
participant P as Parent/Anbieter
participant SO as Freigegebene Objekte
participant T as Mandant
P->>P: VM-Snapshot erstellen
P->>SO: Geteiltes Objekt erstellen
(Typ: VM, Empfänger: Mandant)
SO-->>T: Objekt erscheint als „Eingehend“
T->>SO: VM auswählen und importieren
SO->>T: VM im Mandanten erstellt
(neue MAC-Adressen optional)
T->>T: Konfigurieren & einschalten
```
{% hint style="info" %}
**Kommen Sie von VMware oder Nutanix?**
Mit den freigegebenen Objekten von VergeOS können Anbieter und Mandant VMs per Referenz austauschen — ohne vollständige Festplattenkopien, und derselbe Mechanismus funktioniert in beide Richtungen. Erstellen Sie einen Snapshot der VM, ein auf den Empfängermandanten beschränktes freigegebenes Objekt, und der Empfänger importiert es; auf die zugrunde liegenden vSAN-Blöcke wird referenziert, statt sie zu kopieren.
{% endhint %}
## Zusammenfassung
VergeOS bietet flexible Mandantenerstellung über drei Methoden -- die **Assistent** für benutzerdefinierte Einmal-Mandanten, **Klonen** zum Duplizieren vorhandener Umgebungen und **Rezepte** für automatisierte standardisierte Bereitstellungen. Nach der Erstellung können Mandanten mit externen IP-Adressen für Netzwerkkonnektivität, geteilten Dateien für Medien und Images sowie geteilten VM-Snapshots zur Workload-Verteilung konfiguriert werden. Jede dieser Operationen nutzt die native vSAN-Architektur von VergeOS für Effizienz, und die architektonische Isolation des Mandanten stellt sicher, dass alle geteilten Ressourcen nach dem Import in die eigene Umgebung des Mandanten korrekt getrennt sind.
Im nächsten Abschnitt werden wir **Tenant-Rezepte** -- das Automatisierungs-Framework, das eine schnelle, standardisierte VDC-Bereitstellung in großem Maßstab ermöglicht.
---
# 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/learn-the-platform/de/modul-7-multi-tenancy/02-creating-tenants.md?ask=&goal=
```
`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.