Knowledge Base
Find answers, guides and solutions for GateControl - Server
🚀 Installation & Setup
9 ArticlesBackend HTTPS for Self-Signed Certificates
Backend HTTPS for Self-Signed Certificates Some services only accept HTTPS connections using self-signed certificates....
Read moreEnable Compression
Enable Compression Compresses HTTP responses with Gzip and Zstd — reduces transferred data by 60-80% for text content l...
Read moreForce HTTPS with Let's Encrypt
Force HTTPS with Let's Encrypt Enables automatic TLS encryption with Let's Encrypt certificates. HTTP requests are redi...
Read moreDefault credentials and first login
Default Credentials FieldDefaultEnvironment Variable UsernameadminGC_ADMIN_USER PasswordchangemeGC_ADMIN_PASSWORD Chan...
Read moreDocker Installation on Various Operating Systems
GateControl supports automatic Docker installation on the following systems:Ubuntu / DebianFedora / CentOS / RHEL / Rock...
Read moreConfigure Domains & DNS
Configure Domains & DNS GateControl acts as a reverse proxy: requests to a domain are forwarded by Caddy to a backend....
Read moreSetting up your license key
There are two ways to set up your GateControl license key: Method 1: Via the web interface (no restart) Open GateContr...
Read morePorts and Network Configuration
GateControl uses host networking (network_mode: host) so that Layer 4 routes can dynamically bind to new ports.PortProto...
Read moreSet Up a WireGuard Client
Set Up a WireGuard Client Recommended Software Operating SystemClientNotes WindowsWireGuard for WindowsOfficial clien...
Read more📖 Usage
4 ArticlesManaging VPN Peers
Under Peers you can create and manage WireGuard VPN peers. Each peer automatically receives:An IP address from the confi...
Read moreSetting Up Reverse Proxy Routes
Under Routes you configure HTTP reverse proxy routes and Layer 4 proxy routes.HTTP RoutesMap external domains to interna...
Read moreUsing Request Tracing for Debugging
When to Use Request Tracing Request Tracing helps when: A route returns 502 or other errors You suspect a redirect loop...
Read moreMaking Synology NAS Accessible via GateControl
With the companion project docker-wireguard-go you can connect a Synology NAS without kernel module support to GateContr...
Read more🔒 Security
4 ArticlesBackup & Restore
GateControl offers full system backup as portable JSON:Peers, routes, route auth configurations, settings, webhooksEncry...
Read moreRoute Auth vs. Basic Auth
Route Auth vs. Basic Auth GateControl offers two authentication methods per route. Here is a direct comparison: Compari...
Read moreSetting Up the AI Bot Blocker
Enable AI Bot Blocker The AI Bot Blocker protects your services from unwanted AI crawlers like GPTBot, Google Gemini, De...
Read moreSet Up Geo-Blocking
Set Up Geo-Blocking With IP access control, you can restrict access to routes by IP address, CIDR range, or country. Mo...
Read more🌐 Networking & Routing
1 Articles⚙️ Advanced
3 ArticlesConfigure Retry on Error
Configure Retry on Error Automatically retries failed requests to the backend — ideal for brief outages, backend restar...
Read moreUnderstanding the Circuit Breaker
Understanding the Circuit Breaker What Does It Do? When a backend fails repeatedly, the circuit breaker blocks all requ...
Read moreRequest Mirroring for Shadow Deployments
Request Mirroring for Shadow Deployments What Does It Do? Duplicates every HTTP request asynchronously to secondary bac...
Read more