← Back to All Troubleshooting Articles

Troubleshooting · Xray Routing

How to Fix XrayCore Error / geo-date (geosite) in Happ & INCY

If Happ or INCY shows an XrayCore Error, geo-date, or geosite error when connecting, follow these two steps to switch to the built-in OutlineKeysRobot 4 JSON routing profile and verify your Xray core version.

  1. Step 

    Step 1. Select the "OutlineKeysRobot 4 JSON" Routing Profile

    Open Settings → Routing in Happ or INCY, enable Routing, and select the OutlineKeysRobot 4 JSON profile that is bundled with your OOKVPN subscription.

    Routing settings in Happ
  2. Step 

    Step 2. On iOS: Ensure Global Happ (Xray >= 26.7.8) Is Installed

    Check the bottom of Happ Settings to verify that your Xray core version is at least 26.7.8. Replace outdated "Happ Plus" builds with Global Happ (Kazakhstan App Store guide) or use UXWay / Shadowrocket.

Other Troubleshooting Articles

Games · Windows & Android Why Steam, CS2, Deadlock & Online Games Fail with VPN (Per-App Proxy Exclusions)

How to add steam.exe, cs2.exe, deadlock.exe & remote desktop apps to direct bypass in Happ & INCY

Russian Banks & Local Sites Russian Banks, Gosuslugi & Marketplaces Not Opening While VPN Is Active

Split tunneling setup across Happ, INCY, Shadowrocket, and Throne

Mobile Data · Anti-DPI VPN Not Working on Mobile Data (Carrier White-Lists & TSPU Blocking)

Connecting to White Russian (Ultra Hysteria2, xHTTP, gRPC) & enabling tlshello fragmentation

Telegram · Calls & Proxy Telegram Voice & Video Calls Not Connecting (Local SOCKS5 127.0.0.1:10808 & TUN Setup)

How to connect Telegram to Happ local SOCKS5 port 10808 for reliable UDP calls

Devices · HWID & Slots HWID Device Limit Reached: How to Unlink Devices or Reissue Your Key URL

1-click HWID reset, enabling Send HWID in Shadowrocket/Throne, and changing your subscription URL

Policy · Torrents (P2P) Temporary Subscription Suspension Due to Torrents (P2P) & Background Game Launchers

How automatic P2P protection works and which apps seed P2P traffic in the background

iOS & Apple TV · Stability VPN Disconnects on iPhone / iPad or Happ Fails to Connect on Apple TV (tvOS)

No Limit mode in Happ, Xray-TUN in INCY, and recommended tvOS clients

Windows & macOS · Network TUN Mode Connected on Windows or macOS, But Websites Do Not Open (Firewall & Admin Rights)

Unblocking the virtual TUN adapter in Windows Defender Firewall and allowing apps in macOS Gatekeeper

Support · Bot Mini App How to Contact OOKVPN Support in the Bot Mini App & What Info (HWID, OS) to Include

Using the "Support" (🎧) → "+ New Ticket" tab inside @ookvpn and copying your HWID device list

Troubleshooting & Support

Browse our step-by-step troubleshooting articles below, ask our online assistant, or contact a live operator inside the @ookvpn Mini App ("Support" 🎧 → "+ New Ticket").

OOKVPN Support Online · 24/7
25/25
Hello! I am the OOKVPN (@ookvpn) assistant. Ask your question below or pick a quick topic — I will guide you step-by-step or help you contact a live operator in the bot "Support" tab.