VPN EnterpriseDocs
Documentation›VPN Service›Troubleshooting

Troubleshooting Guide

Diagnose and resolve common VPN issues quickly and effectively

Quick Problem Search
Search for your specific issue or browse common problems below

Common Issues

VPN Connection Fails
connectionhigh priority

Common Symptoms

  • Cannot establish connection
  • Authentication failed
  • Timeout errors

Likely Causes

  • Incorrect credentials
  • Firewall blocking
  • Network configuration
Slow Internet Speed
performancemedium priority

Common Symptoms

  • Reduced download/upload speeds
  • High latency
  • Page loading delays

Likely Causes

  • Server overload
  • Protocol inefficiency
  • Bandwidth limitations
DNS Resolution Issues
dnshigh priority

Common Symptoms

  • Cannot access websites
  • Domain not found errors
  • Intermittent connectivity

Likely Causes

  • DNS leak
  • Incorrect DNS settings
  • ISP blocking
Frequent Disconnections
connectionmedium priority

Common Symptoms

  • Connection drops regularly
  • Auto-reconnect fails
  • Unstable connection

Likely Causes

  • Network instability
  • Power management
  • Protocol issues

Diagnostic Commands

Connection Status
Check current VPN connection status and configuration
vpn-cli status --detailed

Step-by-Step Solutions

1
Verify Credentials
Check username, password, and server details
vpn-cli auth verify
vpn-cli config validate
2
Test Network Connectivity
Ensure basic internet connectivity exists
ping 8.8.8.8
curl -I https://google.com
3
Check Firewall Rules
Verify firewall allows VPN traffic
vpn-cli firewall check
sudo iptables -L | grep -i vpn
4
Try Different Servers
Test connection to alternative servers
vpn-cli server list --available
vpn-cli connect --server nearest

Performance Optimization

Protocol Selection
High ImpactEasy
Choose optimal protocol for your use case
Use WireGuard for best performance
OpenVPN for compatibility
IKEv2 for mobile devices
Server Location
High ImpactEasy
Connect to geographically closer servers
Choose servers in your region
Test multiple locations
Consider server load balancing
MTU Optimization
Medium ImpactMedium
Adjust Maximum Transmission Unit for network
Auto-detect optimal MTU
Test different MTU values
Monitor packet fragmentation
Split Tunneling
High ImpactMedium
Route only necessary traffic through VPN
Identify critical applications
Configure bypass rules
Test application connectivity

Emergency Procedures

Complete VPN Failure
When VPN stops working completely and internet access is blocked

Immediate Actions

  1. Disconnect VPN: vpn-cli disconnect --force
  2. Reset network: vpn-cli network reset
  3. Restart network service: sudo systemctl restart NetworkManager
  4. Test internet: ping 8.8.8.8
Security Breach Suspected
When you suspect unauthorized access or security compromise

Security Response

  1. Disconnect immediately: vpn-cli disconnect --emergency
  2. Revoke all sessions: vpn-cli auth revoke --all-sessions
  3. Generate new keys: vpn-cli keys regenerate --force
  4. Contact support: vpn-cli support emergency --incident security

Support Resources

24/7 Support

Get immediate help from our technical support team

Knowledge Base

Comprehensive guides and tutorials

System Status

Check service status and known issues

Still Need Help?

If you couldn't find a solution to your problem, our support team is ready to help you resolve any issues.