Konfigurationsreferenz

Das meiste, was du je ändern wirst, stellst du in der Weboberfläche ein. Die paar Dinge, die feststehen müssen, bevor Envoryx startet - wo seine Ordner liegen, auf welchen Ports es lauscht, wie lange Sitzungen halten -, sind Umgebungsvariablen an seinem Container. Hier stehen alle an einem Ort, damit du nicht suchen musst.

Umgebungsvariablen

Variable	Standard	Beschreibung
PUID / PGID	99 / 100	uid/gid, unter der die Projektcontainer laufen und der die Projektverzeichnisse gehören - außerhalb von Unraid id -u / id -g deines Benutzers
ENVORYX_LISTEN	:8787	Adresse der Web-Oberfläche und der API
ENVORYX_CONFIG_DIR	/config	persistenter Zustand (SQLite, CA, Schlüssel, erzeugte Konfiguration, Caches); muss ein lokales Dateisystem sein
ENVORYX_PROJECTS_DIR	/projects	Wurzel aller Projektverzeichnisse
ENVORYX_BACKUPS_DIR	/backups, falls vorhanden, sonst /config/backups	wo Projekt-Backups liegen
ENVORYX_PROJECTS_HOST_PATH / ENVORYX_CONFIG_HOST_PATH	erkannt	Host-Pfade hinter /projects und /config, wenn die Erkennung scheitert
ENVORYX_ALLOW_NETWORK_FS	false	auch starten, wenn /config auf NFS/SMB liegt - nicht empfohlen
ENVORYX_PORT_RANGE_START / _END	20000 / 20999	Host-Ports, die an Projekte vergeben werden
ENVORYX_NETWORK_POOL	10.213.0.0/16	IPv4-Bereich, aus dem jedes neue Projektnetz ein /24 bekommt (256 Projekte pro /16); off überlässt die Wahl Docker, dessen Standardbereiche nach etwa 30 Netzen erschöpft sind. Nimm einen Bereich, den dein LAN und dein VPN nicht benutzen
ENVORYX_PUBLIC_HOST	Browser-Adresse	Host für Projekt-Links (auch unter Einstellungen → Domains & HTTPS → Projekt-Links & Entwicklerrechner)
ENVORYX_PROXY_HTTP	:80	HTTP-Listener des Proxys im Container; leer schaltet ihn ab
ENVORYX_PROXY_HTTPS	:443	HTTPS-Listener des Proxys; leer schaltet HTTPS ab
ENVORYX_SSH	:2222	SSH-Server für IDEs; leer schaltet ihn ab
ENVORYX_ADMIN_USER / ENVORYX_ADMIN_PASSWORD	-	ersten Admin ohne Einrichtungsseite anlegen
ENVORYX_SECRET_KEY	-	Schlüssel, der die gespeicherten Geheimnisse verschlüsselt (base64 von 32 Byte oder 64 Hex-Ziffern, z. B. openssl rand -base64 32); ohne ihn verwaltet Envoryx einen in /config/secret.key, siehe Secret Key
ENVORYX_SECRET_KEY_OLD	-	der bisherige Schlüssel, für einen Start nach dem Ändern von ENVORYX_SECRET_KEY
ENVORYX_SESSION_IDLE_TIMEOUT	12h	Sitzungsablauf bei Inaktivität
ENVORYX_SESSION_ABSOLUTE_TIMEOUT	168h	harter Sitzungsablauf
ENVORYX_SECURE_COOKIES	false	Cookies als Secure markieren (hinter HTTPS einschalten)
ENVORYX_UPDATE_CHECK	true	einmal am Tag bei GitHub nach einem neueren Release fragen
ENVORYX_SHUTDOWN_GRACE	8s	wie lange laufende Operationen nach einem Stopp-Signal fertig werden dürfen (unter dem Stopp-Timeout halten)
ENVORYX_LOG_LEVEL	info	debug, info, warn, error
ENVORYX_LOG_FORMAT	json	json oder text
DOCKER_HOST	Unix-Socket	Docker-Endpunkt, z. B. ein Socket-Proxy
TZ	-	Zeitzone für Zeitpläne (Backups, Cron-Jobs), z. B. Europe/Berlin

Die drei Verzeichnisse

Envoryx hält alles an drei Orten. Es hilft zu wissen, was wo liegt - vor allem, wenn du entscheidest, auf welche Platte sie kommen:

Mount	Enthält	Hinweise
/config	Datenbank, CA, SSH-Schlüssel, Einstellungen, Log-Verlauf, Paket-Cache, Ollama-Modelle	nur lokale Platte; unter Unraid am besten der Cache-Pool
/projects	ein Verzeichnis pro Projekt	dein Code - per Bind-Mount in die Projektcontainer eingehängt
/backups (optional)	Projekt- und Instanz-Backups	z. B. auf dem Unraid-Array; ohne es landen Backups in /config/backups

Wie viel Platz auf allen dreien noch frei ist, zeigt dir das Dashboard. Fällt einer unter 2 GiB oder 5 %, bekommst du eine Benachrichtigung, und ein Backup, nach dem weniger als 512 MiB frei wären, startet Envoryx gar nicht erst.

Voraussetzungen

Viel braucht es nicht:

• Linux mit Docker Engine 24 oder neuer (Unraid 6.12+ / 7.x oder jede Distribution)
• x86_64 oder arm64 - alle Envoryx-Images sind Multi-Arch