> For the complete documentation index, see [llms.txt](https://docs.ngsurvey.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ngsurvey.com/de/installation-setup/installation/einstellungen-fur-umgebungsvariablen.md).

# Einstellungen für Umgebungsvariablen

Neben seinen [Systemeinstellungen](/de/installation-setup/system-settings.md) können Sie den Kern von ngSurvey auch mit den folgenden Umgebungsvariablen konfigurieren. Diese Variablen können auch entweder in der web.config-Datei, wenn Sie IIS verwenden, oder in der Datei ngsurvey.settings.json festgelegt werden.

{% hint style="info" %}
In einem standardmäßigen Azure Linux App Service oder einem benutzerdefinierten Linux-Container muss jedes `:` im Variablennamen durch `__` (doppelter Unterstrich).
{% endhint %}

## 🔅 Umgebungsvariablen

* **`NGSurvey:Secret`**&#x56;erschlüsselungsschlüssel, der verwendet wird, um das JWT und Token für Sicherheitselemente zu signieren. Muss mindestens 64 Zeichen lang sein.&#x20;
* **`NGSurvey:AutoDBSetup`** Standardmäßig konfiguriert oder aktualisiert ngSurvey automatisch Ihre Zieldatenbank. Wenn Sie den automatischen Installations-/Upgradeprozess deaktivieren möchten, können Sie diese Variable auf false setzen. In diesem Fall müssen Sie die Datenbank manuell mithilfe der [dacpac](/de/installation-setup/installation/datenbank-backend/microsoft-sql-server.md) Datei für Microsoft SQL Server installieren. MariaDB oder MySQL werden nur direkt von ngSurvey installiert; wir bieten keine Skripte oder Code an, um die Datenbank manuell selbst zu installieren und einzurichten.
* **`NGSurvey:MailingBatchPoolingDelay`**&#x69;st die Verzögerung in Minuten, nach der die versandbezogenen Batches wie das Senden von Kampagnen-E-Mails ausgelöst werden. Standard ist 1 Minute.
* **`NGSurvey:MaxMailingThread`** ermöglicht Ihnen festzulegen, wie viele Worker-Threads während des E-Mail-Versands verwendet werden. Seien Sie vorsichtig bei der Einstellung der Thread-Anzahl, da jeder Thread eine Verbindung zu Ihrem Mailserver öffnet. Der Standardwert ist 2.
* **`NGSurvey:DisableEmailBlacklisting`** deaktiviert die Möglichkeit, E-Mails für Kampagnen auf eine Blacklist zu setzen, wenn auf true gesetzt.
* **`NGSurvey:DisableMobilePhoneNumberBlacklisting`** deaktiviert die Möglichkeit, Mobiltelefonnummern für Kampagnen auf eine Blacklist zu setzen, wenn auf true gesetzt.
* **`NGSurvey:EnableSwagger`** wenn auf false gesetzt, wird der Zugriff auf die API-Dokumentation unter <https://yourngsurveysite/api> deaktiviert.&#x20;
* **`NGSurvey:DistributedCache`**&#x61;ktiviert den verteilten Cache, wenn auf true gesetzt. Der verteilte Cache muss aktiviert sein, wenn Sie ngSurvey auf [einem Cluster](/de/installation-setup/installation/cluster-scale-out-configuration.md) clusterähnlicher Konfiguration
* **`NGSurvey:CacheTimeout`** ngSurvey verwendet interne Caches, um die Leistung zu verbessern. Standardmäßig laufen diese Caches nicht ab. Sie können einen Timeout in Minuten festlegen, wenn Sie eine Ablaufzeit definieren möchten, damit diese Caches in regelmäßigen Intervallen geleert werden.&#x20;
* **`NGSurvey:PanelSyncronizerThreadsNumber`** definiert die Anzahl der Threads, die zur Synchronisierung der Panels mit ihren Datenquellen verwendet werden. Der Standardwert ist 6. Seien Sie vorsichtig, da jeder Thread eine neue Verbindung zu der Datenquelle öffnen kann, mit der Ihr Panel verbunden ist.&#x20;
* **`NGSurvey:Languages`** ein Array von Sprachcodes, die im Administrationsbereich auswählbar sind:&#x20;
* **`NGSurvey:ClusterNode`** definiert, ob die Instanz auf true gesetzt ist, wenn sie auf einem Clusterknoten ausgeführt wird. Instanzen, bei denen der Clusterknoten auf true gesetzt ist, führen keinerlei Hintergrundaufträge aus. Sie sollten die Hintergrundaufträge entweder auf einer separaten Instanz belassen, die keine Umfragen bereitstellt, oder auf nur einer Instanz.&#x20;
* **`NGSurvey:EncryptionKey`** Dieser Verschlüsselungsschlüssel wird für die gesamte Verschlüsselung von Daten auf Datenbankebene verwendet, z. B. für Verbindungszeichenfolgen, Kennwörter und sensible Einstellungen. Muss mindestens 64 Zeichen lang sein. Stellen Sie sicher, dass Sie eine Sicherung des Schlüssels aufbewahren, da Sie ohne den Schlüssel möglicherweise keine Ihrer ngSurvey-Daten wiederherstellen können.
* **`NGSurvey:AccountLockoutThreshold`** Anzahl der Versuche, mit denen sich ein Login vor einer Sperrung authentifizieren kann.
* **`NGSurvey:AccountLockoutDuration`** Anzahl der Minuten, während der das Login-Konto gesperrt ist, bevor eine erneute Authentifizierung erlaubt wird. &#x20;
* **`NGSurvey:EnableHSTS`**&#x61;ktiviert HSTS; wenn Sie SSL verwenden, werden alle Cookies als sicher festgelegt.&#x20;
* **`NGSurvey:WebSetupDisabled`** deaktiviert die webbasierte Installationsoberfläche von ngSurvey, wenn auf true gesetzt.
* **`NGSurvey:CaptchaDisabled`** deaktiviert Captcha-Funktionen, wenn auf true gesetzt.
* **`NGSurvey:TwoFactorDisabled`** deaktiviert die Zwei-Faktor-Authentifizierung bei der Login-Authentifizierung, wenn auf true gesetzt. Kann verwendet werden, um die Zwei-Faktor-Authentifizierung bei auftretenden Problemen zu umgehen.
* **`NGSurvey:ClearActivityLogsOlderThanDays`** Anzahl der Tage, für die die Aktivitätsprotokolldaten aufbewahrt werden.
* **`NGSurvey:ClearActivityLogTresholdDays`** Anzahl der Tage, bevor die Aktivitätsprotokolldaten dauerhaft gelöscht werden.
* **`NGSurvey:EncryptActivityLog`** wenn auf true gesetzt, werden die Aktivitätsprotokolldaten auf Datenbankebene verschlüsselt.
* **`NGSurvey:PersitentMailStorageLocation`** Pfad zu einem Ordner, der zum Sichern von Nachrichten verwendet werden kann, die im Pickup-Exchange-Ordner gespeichert sind, falls Sie den Exchange-Pickup-Ordner zum Versenden von E-Mails verwenden. &#x20;
* **`NGSurvey:MaxAllowedTextSize`** maximal zulässige Textgröße in Bytes, die im System gespeichert werden kann. Kann verwendet werden, um Overflow-Angriffe auf das System zu verhindern. Standard ist 10485760.
* **`NGSurvey:MailServerTest`** wenn auf true gesetzt, werden E-Mails nicht direkt über den konfigurierten Mailserver gesendet.
* **`NGSurvey:LoadTest`** wenn auf true gesetzt, können dieselben Antworten eines Befragten mehrfach übermittelt werden.&#x20;
* **`NGSurvey:AdminDisabled`** wenn auf true gesetzt, werden alle administrativen Funktionen aus der API deaktiviert. Wenn deaktiviert, sind nur die API-bezogenen Funktionen zum Abrufen von Umfragen und zum Übermitteln durch Befragte verfügbar.&#x20;
* **`NGSurvey:CPSPolicy`**&#x77;enn auf "Self" gesetzt, wird die Content Security Policy (CSP) im Browser durchgesetzt. Beachten Sie, dass widgetbasierte Antwort-Elemente und alle benutzerdefinierten JavaScript-bezogenen Funktionen deaktiviert werden, wenn der Wert auf Self gesetzt ist.&#x20;
* **KeyVault:Name** Name des Azure Key Vault, wenn Sie Ihre Umgebungsvariable im Key Vault von Azure speichern möchten.&#x20;
* **AzureAd:ClientId** Client-ID des Azure Key Vault.&#x20;
* **AzureAd:ClientSecret** Client Secret für den Zugriff auf den Azure Key Vault.
* **`NGSurvey:RedisConnectionString`** Verbindungszeichenfolge zum Redis-Caching-Server.
* **`NGSurvey:RedisInstanceName`** optionaler Redis-Instanzname
* **`NGSurvey:ActivityLogAzureWorkspaceId`** Azure Log-Analysen-Workspace-ID zum Protokollieren von Aktivitäten
* **`NGSurvey:ActivityLogAzureAuthenticationId`** Authentifizierungs-ID des Azure Log-Analysen-Agenten
* **`NGSurvey:ActivityLogAwsAccessKeyId`** AWS CloudWatch-Zugriffsschlüssel-ID zum Protokollieren von Aktivitäten
* **`NGSurvey:ActivityLogAwsSecretAccessKey`** Geheimer Schlüssel von AWS CloudWatch
* **`NGSurvey:ActivityLogAwsRegion`** AWS CloudWatch-Region&#x20;
* **`NGSurvey:ActivityLogAwsLogGroup`** AWS CloudWatch-Loggruppe
* **`NGSurvey:ActivityLogApplicationInsightsKey`** Azure Application Insights-Schlüssel zum Protokollieren von Aktivitäten&#x20;
* **`NGSurvey:ActivityLogUseEventLog`** wenn auf true gesetzt, werden Aktivitäten im Windows-Ereignisprotokoll protokolliert.
* **`NGSurvey:AccountJWTAccessTokenExpiration`** Ablaufzeit des JWT-Zugriffstokens auf Kontoebene in Minuten. Standard: 90 Tage, max. 6 Monate.&#x20;
* **`NGSurvey:FormJWTAccessTokenExpiration`** Ablaufzeit des JWT-Zugriffstokens auf Umfrage-/Formular-Ebene in Minuten. Standard: 2 Tage, max. 7 Tage.
* **`NGSurvey:FormJWTAccessTokenExpiration`** Ablaufzeit des JWT-Zugriffstokens auf Umfrage-/Formular-Ebene in Minuten. Standard: 2 Tage, max. 7 Tage.
* **`NGSurvey:PostgresAzureScope`** Azure-Bereich, der die Entra-Zugriffs-Token verwaltet, um Postgres zusammen mit einem von Entra verwalteten Konto zu verwenden.


---

# 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.ngsurvey.com/de/installation-setup/installation/einstellungen-fur-umgebungsvariablen.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.
