Common Issues

Common Issues

"WireGuard configuration could not be set"

Cause: The app is not running as administrator.

Solution: Close the app. Right-click GateControl, then select Run as administrator.

"WireGuard adapter could not be created"

Cause: Missing administrator privileges or a conflict with another WireGuard instance.

Solution:

1. Close other WireGuard clients
2. Start the app as administrator
3. Restart the PC if necessary

Kill Switch Blocks Internet After App Crash

Cause: Firewall rules were not cleaned up during a crash.

Solution: Open an admin command prompt (cmd) and run these commands:

netsh advfirewall firewall delete rule name="GateControl_KS_Block_All_Out"
netsh advfirewall firewall delete rule name="GateControl_KS_Block_All_In"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_Loopback"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_WG_Endpoint"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_VPN_Subnet"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_DHCP"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_LAN_10_0_0_0_8"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_LAN_172_16_0_0_12"
netsh advfirewall firewall delete rule name="GateControl_KS_Allow_LAN_192_168_0_0_16"

Alternatively, simply restart the app — it cleans up orphaned rules automatically.

Server Connection Fails

QR Code Not Recognized

• Check camera permissions in Windows (Settings → Privacy → Camera)
• Hold the QR code well-lit and in focus in front of the camera
• Maintain a minimum distance of about 15 cm

Technical Details

WireGuard Integration

The client uses WireGuard-NT directly via FFI (Foreign Function Interface). No external processes are started. The embedded libraries:

• wireguard.dll — WireGuard-NT kernel implementation
• wintun.dll — TUN network adapter driver

Ports and Protocols