General troubleshooting steps

Try these in order, regardless of your platform:

  1. Force-close and reopen the app
  2. Restart your device
  3. Update the app to the latest version
  4. Clear app data / reinstall the app
  5. Try a different VPN client (e.g., Hiddify → Nekoray)

Platform-specific fixes

Android

App freezes or stops responding:

  • Go to Settings → Apps → Hiddify → Force stop
  • Clear cache: Storage → Clear cache (don’t clear data unless you want to re-add your subscription)
  • If crashes persist, uninstall and reinstall from the Play Store or GitHub

Won’t start after update:

  • Some Android skins (MIUI, OneUI) aggressively kill background apps. Add Hiddify to your battery optimization whitelist.

iOS

App crashes on launch:

  • iOS apps sometimes crash after system updates. Delete and reinstall from the App Store.
  • If using TestFlight (Hiddify beta), make sure your TestFlight build hasn’t expired

VPN toggle won’t turn on:

  • Go to Settings → VPN and delete any old VPN profiles
  • Re-add your subscription in the app
  • Grant VPN permission when prompted

Windows

Hiddify won’t open:

  • Check the system tray - the app may be running minimized
  • End the process in Task Manager and relaunch
  • Run as Administrator if you get permission errors
  • If the app window is blank, update your graphics drivers

“Missing DLL” error:

macOS

“App is damaged” warning:

  • This is a macOS security false-positive for unsigned apps. Right-click the app and choose Open, or go to System Settings → Privacy & Security and click Open Anyway.

System extension won’t load:

  • Go to System Settings → General → Login Items & Extensions → Network Extensions
  • Make sure Hiddify is enabled
  • You may need to restart your Mac after enabling it

Linux

AppImage won’t launch:

chmod +x Hiddify-*.AppImage
./Hiddify-*.AppImage

If you see a FUSE error, install libfuse2:

# Ubuntu/Debian
sudo apt install libfuse2

# Fedora
sudo dnf install fuse

# Arch
sudo pacman -S fuse2

Still crashing?

If the app crashes consistently:

  1. Try a different client (see our Apps guides)
  2. Check if the crash happens only when connected to a specific server
  3. Report the issue with your crash logs

How to collect crash logs

  • Windows: Event Viewer → Windows Logs → Application, search for Hiddify
  • macOS: Console app, search for Hiddify
  • Android: Settings → Developer options → Bug report
  • iOS: Analytics data in Settings → Privacy & Security → Analytics

Send logs to support@sericavpn.com with a description of what you were doing when the crash occurred.