Hiddify Setup Guide
Download Hiddify, import your RookVPN subscription, and connect on any platform.
RookVPN subscriptions work with Hiddify, an open-source cross-platform client for V2Ray-based protocols. This guide expands on the main setup guide with platform notes, verification steps, and troubleshooting for paid and free profiles.
Get a subscription URL
Paid subscribers receive a subscription URL from the RookVPN dashboard after purchase. The URL encodes server profiles, protocols, and rotation settings — treat it as a credential. Do not post it in public forums or commit it to git repositories.
Free users can generate a 24- or 48-hour profile at rookvpn.com/free. Free nodes are suitable for testing Hiddify import and leak checks before upgrading to a paid plan with higher bandwidth and more regions.
Install Hiddify
Download Hiddify from the official GitHub releases for your platform: Windows, macOS, Linux, iOS, or Android. RookVPN uses open-source V2Ray-compatible protocols that Hiddify imports without proprietary plugins. On Linux, prefer the AppImage or distro package listed on the Hiddify project page; on iOS/Android use the store build when available.
After install, grant VPN permissions when prompted — without the system VPN profile, traffic will not tunnel and leak tests will fail immediately.
Import subscription
In Hiddify, choose Import from URL and paste your RookVPN subscription link. The client fetches server profiles automatically. Wait for the sync to complete, then select a node (Helsinki, Montreal, Nuremberg, or others as listed). Tap Connect or Enable System Proxy depending on platform.
If profiles fail to load, check that the subscription URL is complete (no line breaks) and that your account is active. Refresh subscription from the Hiddify menu after purchasing add-ons or region changes.
Verify connection
After connecting, confirm your public IP changed:
- Browser: rookvpn.com/check/check-public-ip
- Terminal: see Check Public IP via Curl
- Full leak suite: VPN leak test (WebRTC, DNS, IPv6)
Run leak tests with VPN connected. Passing means only the VPN exit IP and VPN DNS appear — not your ISP resolver or local WebRTC addresses. Follow the VPN leak testing guide for a step-by-step workflow.
Platform-specific notes
Windows: enable “TUN mode” or system proxy as recommended by Hiddify; some apps bypass per-app proxy without TUN. macOS: approve VPN configuration in System Settings. iOS: use on-demand rules sparingly — they can disconnect when switching Wi‑Fi/cellular. Android: disable battery optimization for Hiddify to avoid kill-switch gaps. Linux: if curl still shows ISP IP while browser shows VPN IP, check split routing in NetworkManager.
Troubleshooting
If nodes fail to connect, refresh the subscription in Hiddify and pick a different region. Ensure system date/time is correct (TLS validation fails on skewed clocks). For persistent DNS leaks, enable VPN DNS override in Hiddify settings and disable custom DNS in the OS. For WebRTC leaks, use browser extensions or disable WebRTC while testing. IPv6 leaks may require disabling IPv6 on the interface or choosing a profile with IPv6 support.
Still stuck? Compare behavior with the visual setup guide or test a free profile from rookvpn.com/free to isolate account vs client issues.