Environment-Variablen
Alle Settings über .env-Datei oder Docker -e-Flags. Eine Beispiel-Datei findest du im Repo unter .env.example.
Pflicht
Abschnitt betitelt „Pflicht“| Variable | Beschreibung |
|---|---|
MS_EMAIL | Microsoft-SSO E-Mail (name@wiss-edu.ch) |
MS_PASSWORD | Microsoft-Passwort |
Ohne diese beiden kann der Scraper sich nicht einloggen.
Häufig genutzt
Abschnitt betitelt „Häufig genutzt“| Variable | Default | Beschreibung |
|---|---|---|
API_TOKEN | auto | Schutz für /api/*-Routen. Leer lassen = Auto-Generierung beim Start (in data/.api-token) |
TELEGRAM_ENABLED | false | Telegram-Bot einschalten |
TELEGRAM_TOKEN | — | Bot-Token von @BotFather |
TELEGRAM_ALLOWED_USER_ID | — | Deine User-ID von @userinfobot |
ALLOW_UI_CREDENTIALS | true | Credentials im UI änderbar. Settings werden mit AES-256-GCM verschlüsselt |
TZ | Europe/Zurich | Zeitzone für Logs/Telegram |
PORT | 3000 | HTTP-Port |
TRUST_PROXY | 1 | Anzahl Hops dem X-Forwarded-For vertraut wird |
SSE_LOG_LEVEL | info,warn,error | Welche Logger-Level an Browser-Clients gestreamt werden |
Erweitert
Abschnitt betitelt „Erweitert“URLs (env-only, kein UI-Zugriff = SSRF-Schutz)
Abschnitt betitelt „URLs (env-only, kein UI-Zugriff = SSRF-Schutz)“| Variable | Default | Beschreibung |
|---|---|---|
TOCCO_BASE | https://wiss.tocco.ch | Tocco-Basis-URL |
NOTEN_URL | Notenseite | Vollständige Tocco-Noten-URL |
STUNDENPLAN_URL | Stundenplanseite | Vollständige Tocco-Stundenplan-URL |
USER_PK | — | Tocco-User-Primärschlüssel |
Browser / Scraper
Abschnitt betitelt „Browser / Scraper“| Variable | Default | Beschreibung |
|---|---|---|
HEADLESS | true | false = sichtbarer Browser (Debug) |
SLOW_MO | 0 | Millisekunden zwischen Playwright-Aktionen |
DEBUG_SCRAPER | false | DOM-Dumps bei Fehlern |
Web-Push (VAPID)
Abschnitt betitelt „Web-Push (VAPID)“| Variable | Default | Beschreibung |
|---|---|---|
VAPID_PUBLIC_KEY | auto | Web-Push Public-Key. Auto-generiert in data/vapid.json falls leer |
VAPID_PRIVATE_KEY | auto | Web-Push Private-Key |
VAPID_SUBJECT | mailto:admin@example.com | Kontakt-Adresse für Push-Provider |
NAS / Container-Permissions
Abschnitt betitelt „NAS / Container-Permissions“| Variable | Default | Beschreibung |
|---|---|---|
PUID | 1000 | Container-User-ID (siehe NAS / Unraid) |
PGID | 1000 | Container-Group-ID |