Hiddify is a sing-box client available as a free download; connecting still requires a working server profile. Public or free profiles depend on their providers, so installing the app does not guarantee a working server service. It can import supported Clash/Clash Meta subscriptions but does not run Mihomo. Check protocols, routing, DNS and client-specific overrides when migrating; identical YAML behavior is not guaranteed.
On Android, use the Google Play link from the official website; get an APK from official GitHub Releases when needed. Use the App Store on iPhone and iPad. For Windows, Linux and standalone Mac builds, choose a file matching your OS and architecture from the project Releases. If you need System proxy on Mac, choose the standalone build. The Mac App Store build does not offer that mode; for everyday use, you can use its VPN mode to handle app traffic and authorize the network extension when prompted. Check each channel’s version, minimum system requirements and permission flow separately.
Check that the complete subscription URL is valid, is not a login page and is reachable on the original network. Add URLs through + → Clipboard or Manually; use + → File for local configuration files. Distinguish download failures, unsupported response formats and a downloaded profile that fails during core loading. For the last case, inspect the configuration or permission error rather than assuming the link expired. Select the imported profile and check its servers. Changing Region or reinstalling does not repair invalid input; redact subscription credentials before sharing errors.
On Windows, Linux and standalone macOS builds, start with System proxy to test browsers that honor system proxy settings. Proxy exposes a local port that apps must configure manually. Choose VPN for wider capture and complete its required permissions. Mac App Store builds do not offer System proxy: use their VPN mode and approve the network extension as requested. Phones also need system VPN consent on first connection. Proxy, Direct and Block in Routing are outbound actions for captured requests, not service modes; they do not capture excluded traffic.
Open the profile menu’s Share action in View all profiles. Remote subscriptions offer Subscription link in Share profile; local profiles have no such link. For either type, use Configuration → Save to export the current JSON. Retain original local files and separately record the selected server, Region, DNS, Routing and Service mode. Before updating the subscription or app, changing channels or uninstalling, confirm that the link and required files were saved successfully. On the new setup, restore a URL through + → Clipboard or Manually, or a local JSON through + → File. Select the profile, recheck the server, those settings and connection permissions, then test your target site. Exported JSON is a runtime-configuration snapshot, not a full backup of all app data or cross-platform settings. Store links and files privately because they can contain credentials.
Refresh and select the profile, test the same target with another working server, and check app exclusions and competing VPNs. If Windows VPN reports elevation is required, exit Hiddify fully from the tray, reopen as administrator, select VPN and reconnect; return to the tested System proxy mode if errors persist. Change Android background/battery restrictions only when the system actually stops the app. On other platforms, record the real connection or configuration error when a connection drops shortly after starting. Disconnect to verify baseline networking, then retest a known-working profile and retain the platform, version, network and redacted logs.
