Remok | Docs

Client Troubleshooting

Diagnose and resolve the most common client and connectivity issues.

Cannot Connect to Gateway

Check 1: Server is reachable

# Test port connectivity from client machine
telnet vpn.your-company.com 443
# or
nc -vz vpn.your-company.com 443

Check 2: Firewall rules on server

# Allow VPN port (example for Ubuntu / ufw)
sudo ufw allow 443/udp
sudo ufw allow 443/tcp
sudo ufw allow 8443/tcp

Check 3: Docker containers are running

docker compose ps
# All containers should show "Up"

Connected But No Internal Access

  • Confirm the routing configuration pushes the correct subnet (e.g., 192.168.0.0/16)
  • Enable IP forwarding: echo 1 > /proc/sys/net/ipv4/ip_forward
  • Check internal firewall allows traffic from the VPN subnet (10.8.0.0/24)

Login Failed

  • Verify username exists in Admin Console → Users
  • Check the account is not locked (Admin Console → Users → Account Status)
  • If using LDAP, ensure the user exists in the synced directory and the sync has completed
  • Check admin logs for detailed error messages

Collecting Diagnostic Logs

# Server-side logs
docker compose logs --tail=200 remok

# Export recent VPN logs (Admin Console)
Admin Console → Logs → VPN Sessions → Export

Get Help

If you cannot resolve the issue:

← Cross-Platform Clients