Wissensdatenbank

Backend HTTPS für selbstsignierte Zertifikate

Einrichtung Über die UI Der Toggle sitzt im Route-Wizard in Step 2 — Transport, direkt neben Force HTTPS. Route erstell...

Read more

Komprimierung aktivieren

Einrichtung Über die UI Der Toggle sitzt im Route-Wizard in Step 2 — Transport, neben Force HTTPS und Backend HTTPS. Ro...

Read more

Force HTTPS mit Let's Encrypt

Einrichtung Über die UI Der Toggle sitzt im Route-Wizard in Step 2 — Transport. Route erstellen oder bearbeiten In Step...

Read more

Standard-Zugangsdaten und erster Login

6. Erster Login Im Browser GC_BASE_URL öffnen, z.B. https://gate.example.com. Username: admin (konfigurierbar via GC_AD...

Read more

Docker-Installation auf verschiedenen Betriebssystemen

Inhaltsverzeichnis Voraussetzungen Verzeichnislayout Setup-Dateien herunterladen .env konfigurieren Erster Start Erster...

Read more

Domains & DNS konfigurieren

Einrichtung Voraussetzung: DNS-Server im VPN Der DNS-Server (Pi-Hole/AdGuard) muss über das WireGuard-VPN erreichbar sei...

Read more

Lizenzschluessel einrichten

Feature-Checks anwenden Der License-Service wird an drei Stellen gequeried: 1. Middleware — Server-side API-Guard // src...

Read more

Ports und Netzwerkkonfiguration

1. Voraussetzungen Hardware Ressource Minimum Empfohlen CPU 1 vCPU 2 vCPU RAM 1 GB 2 GB Platte 20 GB 40 GB (m...

Read more

WireGuard Client einrichten

3. Peers / Clients verwalten Die Seite Peers & Clients ist zweigeteilt: Home Gateways — oben, als aufklappbare Karten m...

Read more

Ersten Home-Gateway einrichten

Du hast eine NAS, einen Mini-PC oder einen Raspberry Pi im Heimnetz und willst Dienste daraus (Router-Admin, NAS-WebUI,...

Read more

GateControl upgraden

11. Updates Automatisches Update cd /opt/gatecontrol ./update.sh update.sh pullt das neueste Image aus GHCR, erzeugt de...

Read more

Installation verifizieren

8. Installation verifizieren Container-Health cd /opt/gatecontrol docker compose ps Erwartet: NAME IMAGE...

Read more

Migration bestehender Installationen

12. Migration bestehender Installationen Falls du eine ältere GateControl-Installation mit einem Named Docker Volume has...

Read more

VPN Peers verwalten

Einrichtung Über die UI Der Toggle sitzt im Route-Wizard in Step 4 — Access, direkt über der Peer-Checkliste. Route ers...

Read more

Reverse Proxy Routen einrichten

Du hast einen Dienst, den du aus dem Internet unter deiner eigenen Domain erreichen willst — z.B. Nextcloud auf der NAS...

Read more

Request Tracing für Fehlersuche nutzen

Anwendungsbeispiele Beispiel 1: Route gibt 502 zurück "Mein Nextcloud unter cloud.example.com gibt 502 zurück" Debug-...

Read more

Synology NAS über GateControl erreichbar machen

Use Cases Synology DSM (Port 5001) Synology NAS leitet Port 5000 (HTTP) automatisch auf Port 5001 (HTTPS) um. Das DSM-Ze...

Read more

Backup & Restore

Zielgruppe: Ops. Dieses Kapitel beschreibt was in einem Backup steckt, wie du manuelle und automatische Backups anstößt,...

Read more

Route Auth vs. Basic Auth

Vergleichstabelle Eigenschaft Keine Auth Basic Auth Route Auth Sicherheitsstufe Keine Mittel Hoch Login-UI Kein...

Read more

AI-Bot-Blocker einrichten

Konfiguration Bot-Blocker aktivieren Route öffnen (Edit-Modal → Security-Tab) AI Bot Blocker Toggle aktivieren Modus wä...

Read more

Geo-Blocking einrichten

Einrichtung Über die UI Der Toggle sitzt im Route-Wizard in Step 4 — Access (zusammen mit Peer ACL, Rate Limiting und Up...

Read more

HTTP vs. L4 Routing — Wann nutze ich was?

Erklärt den Unterschied zwischen HTTP-Routing (Layer 7, Domain-basiert) und L4-Routing (Layer 4, Port-basiert) — wann we...

Read more

TLS / Zertifikate verstehen und debuggen

Du öffnest /certificates in der Admin-UI und siehst eine Tabelle deiner Domains mit Status-Tags. Eine Domain zeigt "HTTP...

Read more

Gateway-Pool für Failover einrichten

Setup 1. Voraussetzungen Mindestens 2 Gateway-Peers angelegt (/peers, peer_type=gateway) Beide Gateways müssen die Back...

Read more

Retry on Error konfigurieren

Einrichtung Über die UI Der Toggle sitzt im Route-Wizard in Step 5 — Reliability (zusammen mit Circuit Breaker und Reque...

Read more

Circuit Breaker verstehen

Einrichtung Über die UI Der Toggle sitzt im Route-Wizard in Step 5 — Reliability (zusammen mit Retry und Request Mirrori...

Read more

Request Mirroring für Shadow Deployments

Einrichtung Über die UI Der Toggle sitzt im Route-Wizard in Step 5 — Reliability (zusammen mit Retry und Circuit Breaker...

Read more

Gateway-Routen auf Layer 4 (TCP/UDP-Port-Forwarding)

Seit v1.42.0 funktionieren L4-Routen mit target_kind=gateway end-to-end. Damit lässt sich jeder TCP- oder UDP-Port eines...

Read more

Gateway-Route Backend HTTPS

Seit v1.41.11 honoriert der Home-Gateway-Container den bestehenden Backend HTTPS-Toggle auch für Gateway-Routen. Der Gat...

Read more

Client-API: Gateway-Companion integrieren

API-Endpoints fuer die Kommunikation zwischen GateControl Desktop-Clients (Windows, macOS, Linux) und dem GateControl Se...

Read more

Gateway-Pool: Load-Balancing aktivieren

Load-Balancing-Mode im Detail Aktivierung Eine Route nutzt LB nur, wenn alle drei Bedingungen stimmen: route.target_poo...

Read more

RDP-Zugriff auf Windows einrichten

Du willst auf einen Windows-PC (Büro-Desktop, Homeoffice-Laptop, Windows Server) von außen per Remote Desktop zugreifen....

Read more

RDP über Home-Gateway (Option B)

Alternative: Option A — L4-Gateway-Route direkt anlegen. Was es ist Eine RDP-Route in der Admin-UI bekommt einen neuen A...

Read more

RDP über L4-Gateway-Route (Option A)

Alternative: Option B — RDP-Route mit Access-Mode gateway. Wann nutzen? Passt wenn du schnell einen RDP-Endpunkt vom Int...

Read more

RDP-Zugangsdaten im Credential-Vault

Credential-Vault Speicherung Bei credential_mode='user_only' wird nur username_encrypted gesetzt (Passwort gibt der User...

Read more

Fehlerbehebung

Zielgruppe: Ops im Vor-Ort-Einsatz. Die Einträge folgen dem Muster Symptom → Ursachen → Prüfung → Fix. Jeder Befehl ist...

Read more

Gateway-Pools: Fehlerbehebung

Troubleshooting Failover hat nicht stattgefunden # 1. Ist Peer wirklich als down erkannt? sqlite3 /data/gatecontrol.db "...

Read more