> 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/run-the-platform/de/systemadministration/advanced-system-settings.md).

# Erweiterte Systemeinstellungen

Referenz für alle erweiterten Systemeinstellungen in VergeOS, einschließlich NTP, SMART-Schwellenwerte, Sitzungstimeouts, MAC-Präfix, Migrationssteuerungen, Zwei-Faktor-Authentifizierung und vSAN-Konfiguration.

Diese Einstellungen finden Sie unter ***System > Einstellungen > Erweitert***.

{% hint style="danger" %}
**Vorsicht bei erweiterten Einstellungen**

Diese Einstellungen sollten nur von erfahrenen Administratoren oder unter direkter Anleitung des VergeIO-Supports geändert werden. Änderungen können das Systemverhalten und die Leistung erheblich beeinflussen. Immer:

1. Die Auswirkungen vollständig verstehen, bevor Änderungen vorgenommen werden
2. Änderungen zuerst in einer Nicht-Produktionsumgebung testen
3. Alle Änderungen für spätere Referenz dokumentieren
4. Einen Rollback-Plan bereithalten

Für detaillierte Informationen zu diesen Einstellungen und ihren Auswirkungen wenden Sie sich bitte an den VergeIO-Support.
{% endhint %}

{% hint style="info" %}
**Einige Einstellungen können leer sein, wenn sie nicht konfiguriert sind.**
{% endhint %}

| Einstellung                                                                                                                   | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                       | Standardwert                                                |
| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| ***Automatische Prüfung auf Katalogaktualisierungen***                                                                        | Intervall (in Stunden), in dem Rezeptkataloge automatisch auf Änderungen geprüft werden.                                                                                                                                                                                                                                                                                                           | 24                                                          |
| ***System-Snapshot-Profil***                                                                                                  | Snapshot-Profil, das für System-Snapshots verwendet wird. Das Profil „System Snapshots“ wird während der Installation automatisch erstellt. Sie können dieses enthaltene Profil ändern oder hier ein anderes Profil auswählen.                                                                                                                                                                     | System Snapshots                                            |
| ***Kontakt-E-Mail für die Verarbeitung von Offline-/Air-Gap-Lizenzdateien***                                                  | E-Mail-Adresse, die für die Verarbeitung von Lizenzdateien in Offline- oder Air-Gapped-Umgebungen verwendet wird.                                                                                                                                                                                                                                                                                  | <license@verge.io>                                          |
| ***Tag des Monats zur Erstellung des Abrechnungsberichts***                                                                   | Legt den Tag jedes Monats fest, an dem das System Abrechnungsberichte erstellt.                                                                                                                                                                                                                                                                                                                    | 1                                                           |
| ***Standard-VM-Laufwerkstier***                                                                                               | Legt das Standard-Speichertier für neue VM-Laufwerke fest. Höhere Tiers bieten in der Regel bessere Leistung.                                                                                                                                                                                                                                                                                      | 4                                                           |
| ***Standard-Cluster für VMs***                                                                                                | Legt den Standard-Cluster fest, in dem neue VMs erstellt werden, sofern nichts anderes angegeben ist.                                                                                                                                                                                                                                                                                              |                                                             |
| ***Standard-Cluster für VMware-Service-Container***                                                                           | Kennzeichnet den Standard-Cluster für neue VMware-Service-Container-Bereitstellungen.                                                                                                                                                                                                                                                                                                              |                                                             |
| ***Standard-Cluster für Netzwerke***                                                                                          | Legt den Standard-Cluster für die Erstellung neuer Netzwerke fest.                                                                                                                                                                                                                                                                                                                                 |                                                             |
| ***Standard-Cluster für Mandantenknoten***                                                                                    | Legt den Standard-Cluster für neue Zuweisungen von Mandantenknoten fest.                                                                                                                                                                                                                                                                                                                           |                                                             |
| ***Standard-MTU für externe Netzwerke***                                                                                      | Legt die standardmäßige Größe der Maximum Transmission Unit (MTU) für externe Netzwerke fest.                                                                                                                                                                                                                                                                                                      | 1500                                                        |
| ***Standard-Failover-Cluster für VMs***                                                                                       | Kennzeichnet den sekundären Cluster für das VM-Failover, falls der primäre Cluster nicht verfügbar ist.                                                                                                                                                                                                                                                                                            |                                                             |
| ***Standard-Failover-Cluster für VMware-Container***                                                                          | Legt den Backup-Cluster für das Failover von VMware-Containern fest.                                                                                                                                                                                                                                                                                                                               |                                                             |
| ***Standard-Failover-Cluster für Netzwerke***                                                                                 | Legt den sekundären Cluster für das Netzwerk-Failover fest.                                                                                                                                                                                                                                                                                                                                        |                                                             |
| ***Standard-Failover-Cluster für Mandantenknoten***                                                                           | Kennzeichnet den Backup-Cluster für das Failover von Mandantenknoten.                                                                                                                                                                                                                                                                                                                              |                                                             |
| ***Standard-MTU für interne Netzwerke***                                                                                      | Ändert die standardmäßige MTU aller erstellten internen Netzwerke                                                                                                                                                                                                                                                                                                                                  | 9000                                                        |
| ***Standard-Adresse für interne Netzwerke***                                                                                  | Ändert das standardmäßige Netzadressschema aller erstellten internen Netzwerke                                                                                                                                                                                                                                                                                                                     | 192.168.0.0/24                                              |
| ***Standard-Tier für Mediendateien***                                                                                         | Legt das standardmäßige Speichertier fest, das für die Speicherung hochgeladener Dateien verwendet wird                                                                                                                                                                                                                                                                                            | 4                                                           |
| ***Standard-Netzwerkadresse für Mandanten***                                                                                  | Das Ändern der standardmäßigen Netzwerkadressierung wird in der Regel nicht empfohlen. Arbeiten Sie eng mit dem VergeOS-Support zusammen, um Änderungen an der Netzwerkadressierung umzusetzen.                                                                                                                                                                                                    | 100.96.255.0/24                                             |
| ***IPv6 aktivieren***                                                                                                         | Der IPv6-Verkehr in das System hinein und aus dem System heraus ist standardmäßig blockiert. Diese Einstellung muss nicht geändert werden, um internen VM-zu-VM-IPv6-Verkehr zu erlauben.                                                                                                                                                                                                          | false                                                       |
| ***Fehlgeschlagene Anmeldeversuche, bevor ein Konto gesperrt wird (0 deaktiviert die Sperrung)***                             | Legt die Anzahl aufeinanderfolgender fehlgeschlagener Anmeldeversuche fest, die zulässig sind, bevor ein Konto vorübergehend gesperrt wird. Wenn Sie dies auf 0 setzen, wird die Sperrfunktion deaktiviert. Hinweis: VergeOS verfügt über integrierten Schutz vor Brute-Force-Angriffen. Mit Vorsicht aktivieren, da aggressive Sperren potenziell zu Denial-of-Service-Situationen führen können. | 0                                                           |
| ***Die Datenbank des Anwendungs-Frameworks alle X ms leeren***                                                                | **Diese Einstellung nicht ändern, es sei denn, der VergeIO-Support weist ausdrücklich dazu an**                                                                                                                                                                                                                                                                                                    | 5000                                                        |
| ***Historische Langzeitstatistiken laufen alle X Sekunde(n) ab***                                                             | Die Standardwerte für die Ablaufeinstellungen historischer Statistiken sind für 95-Perzentil-Berechnungen/Reporting optimiert. Der Standard für den Ablauf von Langzeitstatistiken erlaubt mehr als 30 Tage, damit Monatsdaten verfügbar bleiben.                                                                                                                                                  | 3888000                                                     |
| ***Historische Kurzzeitstatistiken laufen alle X Sekunde(n) ab***                                                             | Die Standardwerte für die Ablaufeinstellungen historischer Statistiken sind für 95-Perzentil-Berechnungen optimiert                                                                                                                                                                                                                                                                                | 300                                                         |
| ***Liste von NTP-Servern, mit denen die Zeit synchronisiert wird (durch Leerzeichen getrennt)***                              | In VergeOS 26.2 und höher ändern Sie die NTP-Server unter **System > Zeiteinstellungen**. Siehe [Zeiteinstellungen](/run-the-platform/de/systemadministration/time-settings.md).                                                                                                                                                                                                                   | 0.pool.ntp.org 1.pool.ntp.org 2.pool.ntp.org 3.pool.ntp.org |
| ***Anmeldebanner-Überschrift***                                                                                               | Legt den Überschriftentext fest, der im Banner der Anmeldeseite angezeigt wird. Kann verwendet werden, um organisatorische oder sicherheitsrelevante Hinweise anzuzeigen.                                                                                                                                                                                                                          |                                                             |
| ***Anmeldebannertext***                                                                                                       | Definiert den Haupttext, der im Banner der Anmeldeseite angezeigt wird. Wird typischerweise für rechtliche Hinweise, Nutzungsrichtlinien oder systemspezifische Mitteilungen verwendet.                                                                                                                                                                                                            |                                                             |
| ***MAC-Adresspräfix für Maschinen-NICs***                                                                                     | Standard ist das bei IEEE registrierte OUI-Präfix von Verge.io (auch Yottabyte genannt). VergeOS verwendet dieses OUI plus eine System-ID, um eindeutige MAC-Adressen sicherzustellen.                                                                                                                                                                                                             | F0:DB:30                                                    |
| ***MSS (Maximale Segmentgröße) der Standardroute des Kernnetzwerks (auf 1460 für eine MTU von 1500 gesetzt)***                | **Diese Einstellung nicht ändern, es sei denn, der VergeIO-Support weist ausdrücklich dazu an**                                                                                                                                                                                                                                                                                                    | 1460                                                        |
| ***Zeitüberschreitung für den Stromzyklus bei Maschinenmigration***                                                           | Legt die maximale Zeit (in Sekunden) fest, die das System bei einer nicht reagierenden VM während der Migration wartet, bevor ein Stromzyklus eingeleitet wird. Dies hilft zu verhindern, dass Migrationsprozesse auf unbestimmte Zeit hängen bleiben.                                                                                                                                             | 1800                                                        |
| ***Geschwindigkeitsdrosselung für Maschinenmigration (Bytes/Sek.)***                                                          | Legt die maximale Datenübertragungsrate für VM-Migrationen fest. Dies hilft, die Migrationsgeschwindigkeit mit der Netzwerkleistung für andere Vorgänge in Einklang zu bringen. Der Standardwert erlaubt ungefähr 1 GB/s.                                                                                                                                                                          | 1048576000                                                  |
| ***Maximale gleichzeitige Maschinenmigrationen***                                                                             | Begrenzt die Anzahl der VM-Migrationen, die gleichzeitig im Cluster stattfinden können. Dies hilft, die Ressourcenauslastung während Migrationsvorgängen zu steuern.                                                                                                                                                                                                                               | 1                                                           |
| ***Maximale gleichzeitige Netzwerkmigrationen***                                                                              | Legt die maximale Anzahl gleichzeitig auszuführender Netzwerkmigrationen fest. Dies hilft, die Ressourcennutzung bei Netzwerk-Failover- oder Ausgleichsvorgängen zu steuern.                                                                                                                                                                                                                       | 10                                                          |
| ***Maximal geschätzte Snapshots pro Profil (0 zum Deaktivieren der Warnung)***                                                | Definiert den Schwellenwert für die Anzahl der Snapshots in einem Profil, bevor eine Warnung ausgelöst wird. Dies hilft, die Speichernutzung und die Verbreitung von Snapshots zu verwalten. Bei 0 wird die Warnung deaktiviert.                                                                                                                                                                   | 200                                                         |
| ***Maximale Anzahl von VXLAN-FDB-Einträgen (jede Änderung außer 0 kann zu verworfenen Paketen führen)***                      | Begrenzt die Anzahl der Einträge in der VXLAN Forwarding Database. Eine Änderung von 0 (unbegrenzt) kann die Netzwerkleistung beeinträchtigen und sollte nur mit Vorsicht vorgenommen werden.                                                                                                                                                                                                      | 0                                                           |
| ***Minuten, für die ein Konto gesperrt wird***                                                                                | Legt die Dauer (in Minuten) fest, für die ein Benutzerkonto nach Überschreiten des Limits fehlgeschlagener Anmeldeversuche gesperrt bleibt. Dies hilft, vor Brute-Force-Angriffen zu schützen.                                                                                                                                                                                                     | 15                                                          |
| ***Name der Domäne für diese Cloud***                                                                                         | Dieses Feld bietet eine Überschreibung für die ansonsten standardmäßige Domäne (aus dem System-SSL-Zertifikat extrahiert)                                                                                                                                                                                                                                                                          |                                                             |
| ***Name dieser Cloud***                                                                                                       | Name zur Identifizierung dieses Systems. Dieser Cloud-Name erscheint in der Benutzeroberfläche und in Berichten/Warnmeldungen, die über Abonnements gesendet werden. Der Cloud-Name identifiziert das System auch in Synchronisationsaufträgen.                                                                                                                                                    | \*Name bei der Installation festgelegt                      |
| ***Physisches Netzwerk für neue Mandanten überschreiben (172.17.0.0/24)***                                                    | **Diese Einstellung nicht ändern, es sei denn, der VergeIO-Support weist ausdrücklich dazu an**                                                                                                                                                                                                                                                                                                    |                                                             |
| ***Anforderung an die Passwortkomplexität***                                                                                  | Zu den Optionen gehören Anforderungen an Kleinbuchstaben, Großbuchstaben, Zahlen und Symbole; Mindestlänge; Erzwingen von Passwortzurücksetzungen (alle Benutzer); jede Kombination von Optionen kann ausgewählt werden.                                                                                                                                                                           | Länge:8                                                     |
| ***Remote-Syslog-Server (tcp: @@ Name/IP:Port, udp: @ Name/IP:Port)***                                                        | Syslog-Server für den Log-Export angeben                                                                                                                                                                                                                                                                                                                                                           |                                                             |
| ***SMART-Maximalstunden, die ein Laufwerk erreichen kann, bevor eine Warnung gesetzt wird***                                  | Legt die maximale Betriebszeit (eingeschaltet) eines Laufwerks fest, bevor ein **„HD-Warnung - Stunden haben den maximalen Schwellenwert überschritten“** Warnung. Standard sind 43.800 Stunden (5 Jahre); der Maximalwert beträgt 87.600 Stunden (10 Jahre). Zusätzliche Informationen zu *SMART-Maximalstunden* unten.                                                                           | 43800                                                       |
| ***SMART-Maximalanzahl aktueller ausstehender Sektoren, die ein Laufwerk haben kann, bevor eine Warnung gesetzt wird***       | Definiert den Schwellenwert für ausstehende Sektoren (Sektoren, die auf eine Neuzuordnung warten), bevor eine Warnung ausgegeben wird. Weist auf mögliche Laufwerksprobleme hin.                                                                                                                                                                                                                   | 1                                                           |
| ***SMART-Maximalanzahl offline nicht korrigierbarer Sektoren, die ein Laufwerk haben kann, bevor eine Warnung gesetzt wird*** | Gibt die maximale Anzahl von Sektoren an, die während Offline-Tests nicht gelesen werden konnten, bevor eine Warnung ausgelöst wird. Deutet auf ernsthafte Laufwerksprobleme hin.                                                                                                                                                                                                                  | 1                                                           |
| ***SMART-Maximalanzahl neu zugeordneter Sektoren, die ein Laufwerk haben kann, bevor eine Warnung gesetzt wird***             | Legt die Grenze für neu zugeordnete Sektoren (schadhafte Sektoren, die ersetzt wurden) fest, bevor eine Warnung ausgegeben wird. Weist auf eine Verschlechterung des Laufwerks hin.                                                                                                                                                                                                                | 1                                                           |
| ***SMART-Maximaltemperatur (Celsius), die ein Laufwerk erreichen kann, bevor eine Warnung gesetzt wird***                     | Definiert die maximale Temperatur, die ein Laufwerk erreichen kann, bevor eine Temperaturwarnung ausgelöst wird. Hilft, hitzebedingte Ausfälle zu verhindern.                                                                                                                                                                                                                                      | 51                                                          |
| ***SMART-Maximalverschleiß (Prozent), den ein Laufwerk erreichen kann, bevor eine Warnung gesetzt wird***                     | Gibt das maximale Verschleißniveau (in Prozent) für SSDs an, bevor eine Warnung ausgegeben wird. Hilft, die Lebensdauer von SSDs zu verfolgen.                                                                                                                                                                                                                                                     | 95                                                          |
| ***SMART-Wert in Minuten, wie oft Diagnosen auf physischen Laufwerken ausgeführt werden***                                    | Legt die Häufigkeit der SMART-Diagnoseprüfungen auf physischen Laufwerken fest. Regelmäßige Prüfungen helfen, mögliche Laufwerksprobleme frühzeitig zu erkennen.                                                                                                                                                                                                                                   | 30                                                          |
| ***Sitzungsablauf (Sekunden)***                                                                                               | Zeitspanne, bevor ein Benutzer automatisch abgemeldet und aufgefordert wird, sich erneut anzumelden.                                                                                                                                                                                                                                                                                               | 259200                                                      |
| ***Zeitüberschreitung bei Inaktivität der Sitzung (Sekunden)***                                                               | Zeitspanne (in der der Benutzer inaktiv ist), bevor er automatisch abgemeldet wird                                                                                                                                                                                                                                                                                                                 | 86400                                                       |
| ***System-ID***                                                                                                               | WARNUNG: Das Ändern Ihrer System-ID wirkt sich auf Ihre VergeOS-Lizenz aus, wodurch das System keine Workloads mehr ausführen kann.                                                                                                                                                                                                                                                                | *variiert*                                                  |
| ***System-Snapshot-Profil***                                                                                                  | Legt das Snapshot-Profil fest, das für Snapshots auf Systemebene verwendet wird. Das Profil „System Snapshots“ wird während der Installation automatisch erstellt. Sie können dieses enthaltene Profil ändern oder hier ein anderes Profil auswählen.                                                                                                                                              | System Snapshots                                            |
| ***TCP-MTU-Probing (0: Deaktiviert, 1: Deaktiviert, aber aktiviert, wenn erkannt, 2: Aktiviert)***                            | Steuert die TCP-Entdeckung der Maximum Transmission Unit (MTU) auf dem Pfad. Wenn aktiviert (2), sondiert das System aktiv, um die optimale MTU-Größe für TCP-Verbindungen zu ermitteln und so Paketfragmentierung zu verhindern. Einstellung 1 deaktiviert das Probing, aktiviert es jedoch, wenn ICMP-Blackholes erkannt werden.                                                                 | 2                                                           |
| ***Vorlage zur Definition für den Syslog-Server (Format siehe rsyslog)***                                                     | Siehe *rsyslog* Dokumentation für die korrekte Eingabesyntax.                                                                                                                                                                                                                                                                                                                                      |                                                             |
| ***Zeitüberschreitung in Sekunden, bevor eine Maschine nicht mehr reagiert***                                                 | Schwellenzeit, nach der das System eine VM als nicht reagierend betrachtet und versucht, die VM auf einem alternativen Knoten zu starten                                                                                                                                                                                                                                                           | 120                                                         |
| ***Zeitüberschreitung in Sekunden, bevor ein nicht reagierender Knoten über IPMI neu gestartet wird***                        | Legt die Dauer fest, die das System wartet, bevor es einen nicht reagierenden Knoten automatisch über IPMI neu startet. Erfordert eine korrekte IPMI-Konfiguration.                                                                                                                                                                                                                                | 3600                                                        |
| ***Zwei-Faktor-Authentifizierung***                                                                                           | Bestimmt die standardmäßige Einstellung für die Zwei-Faktor-Authentifizierung (2FA) für neue Benutzer. Optionen sind „Standardmäßig ein“ (standardmäßig aktiviert) oder „Standardmäßig aus“ (standardmäßig deaktiviert).                                                                                                                                                                           | Standardmäßig aus                                           |
| ***Ablaufzeit der Zwei-Faktor-Authentifizierung für authentifizierte Benutzergeräte***                                        | Legt die Dauer (in Sekunden) fest, für die ein Gerät für 2FA authentifiziert bleibt. Auf 0 setzen für kein Ablaufdatum.                                                                                                                                                                                                                                                                            | 7884000                                                     |
| ***Ablaufzeit der Zwei-Faktor-Authentifizierung für temporäre Codes***                                                        | Definiert die Gültigkeitsdauer (in Sekunden) für temporäre 2FA-Codes.                                                                                                                                                                                                                                                                                                                              | 300                                                         |
| ***Maximale API-Befehle des Webservers***                                                                                     | Begrenzt die maximale Anzahl von API-Befehlen, die gleichzeitig verarbeitet werden können.                                                                                                                                                                                                                                                                                                         | 50                                                          |
| ***Maximale Verbindungen des Webservers***                                                                                    | Legt die maximale Anzahl gleichzeitiger Verbindungen zum Webserver fest.                                                                                                                                                                                                                                                                                                                           | 500                                                         |
| ***Maximales API-Ratenlimit pro Webserver-Sitzung***                                                                          | Beschränkt die Anzahl der API-Anfragen, die eine einzelne Sitzung in kurzer Zeit stellen kann.                                                                                                                                                                                                                                                                                                     | 50                                                          |
| ***vSAN-Host-/IP-Überschreibung***                                                                                            | Gibt einen alternativen Host oder eine alternative IP-Adresse für vSAN-Operationen an, insbesondere für eingehende Site-Synchronisierungen.                                                                                                                                                                                                                                                        |                                                             |
| ***Maximaler vSAN-Nutzungsprozentsatz***                                                                                      | Legt den maximal zulässigen Nutzungsprozentsatz für vSAN-Speicher während eingehender Site-Synchronisierungen fest.                                                                                                                                                                                                                                                                                | 90                                                          |

{% hint style="info" %}
**SMART-Maximalstunden — eine Alterswarnung, kein Ausfall**

Die Warnung „HD Warning - hours exceeded maximum threshold(s)“ bedeutet, dass die kumulierten Einschaltstunden eines Laufwerks den SMART-Maximalstunden-Schwellenwert überschritten haben. Es handelt sich um einen Altersindikator, nicht um einen SMART-Fehlerzustand — ein Laufwerk kann null neu zugeordnete oder ausstehende Sektoren haben und diese Warnung dennoch auslösen.

Ein häufiger Auslöser sind gebrauchte oder neu eingesetzte Laufwerke: Die Einschaltstunden gehören dem Laufwerk selbst, nicht dem Cluster, sodass Laufwerke mit vorheriger Nutzungszeit diese Historie in eine neue Bereitstellung mitbringen.

Zur Behebung:

Wenn die Laufwerke in gutem Zustand sind (SMART-Status OK, keine neu aufgetretenen Defekte): Erhöhen Sie die SMART-Maximalstunden über den aktuellen Wert der Laufwerke, um die Warnung zu unterdrücken. Das Feld ist auf 87.600 Stunden (10 Jahre) begrenzt; ein höherer Wert führt zu einem Validierungsfehler.

**Für HDDs:** Sehr hohe Einschaltstunden erhöhen die Wahrscheinlichkeit eines plötzlichen mechanischen Ausfalls, selbst wenn SMART keine neu zugeordneten oder ausstehenden Sektoren anzeigt. Bei kritischen Workloads sollten Sie eine Erneuerung der Laufwerke einplanen. Ersetzen Sie jeweils ein Laufwerk und lassen Sie vSAN vollständig neu aufbauen, bevor Sie das nächste Laufwerk entfernen, um die Redundanz zu erhalten.

**Für SSDs:** Hohe Einschaltstunden allein sind kein Zuverlässigkeitsproblem. Der Verschleiß von SSDs wird durch Schreibausdauer bestimmt, nicht durch die Einschaltzeit. Verlassen Sie sich bei der Beurteilung des SSD-Zustands eher auf SMART-Verschleißindikatoren (z. B. Verwendeter Prozentsatz, Media Wearout Indicator) als auf Stunden.

**Bestätigen Sie den SMART-Zustand jedes Laufwerks unabhängig, bevor Sie die Warnung verwerfen.**
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/run-the-platform/de/systemadministration/advanced-system-settings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
