Konfigurierbare Umgebungsvariablen
Um den Betrieb von CrispyCMS an Ihre spezifischen Infrastrukturanforderungen anzupassen, stehen Ihnen eine Vielzahl von Umgebungsvariablen zur Verfügung. Diese Variablen steuern fundamentale Aspekte des Systems, von der Datenbankverbindung bis hin zu Feature-Flags und Lokalisierungseinstellungen.
Die Konfiguration erfolgt in der Regel über eine .env-Datei im Wurzelverzeichnis Ihrer Installation oder direkt als Umgebungsvariablen innerhalb Ihrer Container-Orchestrierung (z.B. Docker oder Kubernetes). Eine korrekte Definition dieser Werte ist essenziell für die Stabilität und Sicherheit Ihrer CMS-Instanz.
Einige der hier aufgeführten Variablen, wie z.B. POSTGRES_URI oder Lizenzschlüssel, enthalten sensible Informationen. Stellen Sie sicher, dass diese Daten niemals unverschlüsselt in die Versionsverwaltung (z.B. Git) gelangen. Nutzen Sie für lokale Entwicklungen .env.local oder Secrets-Management-Tools in Produktionsumgebungen.
Variablen-Übersicht
Nachfolgend finden Sie eine kategorisierte Auflistung aller konfigurierbaren Parameter. Nutzen Sie die Reiter, um zwischen den verschiedenen Konfigurationsbereichen zu navigieren.
Grundkonfiguration
Diese Variablen bilden das Rückgrat Ihrer CrispyCMS-Installation. Insbesondere die Datenbankverbindung und die Host-Einstellungen müssen zwingend korrekt gesetzt sein, damit das System startet.
| Variable | Beschreibung | Status | Standardwert |
|---|---|---|---|
| POSTGRES_URI | Vollständige URI zur PostgreSQL-Datenbankverbindung. | Erforderlich | - |
| LICENSE_KEY | Der Lizenzschlüssel zur Aktivierung der Enterprise-Features. | Optional | - |
| HOST | Der primäre Hostname, unter dem das CMS erreichbar ist. | Erforderlich | - |
| ENVIRONMENT | Definiert die Laufzeitumgebung (z.B. production, staging). | Optional | production |
| TZ | Die PHP-Zeitzone für Datumsoperationen. | Optional | UTC |
| PROTO | Das verwendete Protokoll (https oder http) für Link-Generierung. | Erforderlich | - |
| DEFAULT_LOCALE | Die standardmäßige Spracheinstellung für das Frontend. | Optional | en |
| AUTO_ACTIVATE_PLUGINS | Liste von Plugins, die beim Systemstart automatisch aktiviert werden sollen. | Optional | - |
| LOG_LEVEL | Definiert die Detailtiefe der Logs gemäß PSR-3 (z.B. DEBUG, ERROR). | Optional | INFO |
| LANG | Die systemweite PHP Locale Einstellung. | Optional | en_US.UTF-8 |
GeoIP Integration
Für standortbezogene Dienste und Analysen können Sie hier die Verbindung zu MaxMind GeoIP-Diensten konfigurieren. Dies ermöglicht dem CMS, Inhalte basierend auf der Besucherherkunft anzupassen.
| Variable | Beschreibung | Status | Standardwert |
|---|---|---|---|
| MAXMIND_ACCOUNT_ID | Ihre MaxMind Account-ID zur Authentifizierung. | Optional | - |
| MAXMIND_LICENSE | Der zugehörige Lizenzschlüssel für den MaxMind-Service. | Optional | - |
| MAXMIND_EDITION_IDS | Spezifiziert die zu ladenden Datenbank-Editionen. | Optional | GeoLite2-ASN GeoLite2-City… |
Feature Management
CrispyCMS nutzt Unleash für das Management von Feature Flags. Mit den folgenden Variablen können Sie die Standardkonfiguration überschreiben, um Features gezielt zu steuern oder externe Unleash-Instanzen anzubinden.
| Variable | Beschreibung | Status | Standardwert |
|---|---|---|---|
| UNLEASH_API_KEY | Der API-Schlüssel für die Authentifizierung gegenüber dem Unleash-Server. | Optional | - |
| UNLEASH_APP_URL | Die URL zur Unleash-Anwendungsschnittstelle. | Optional | - |