SELECTION GUIDE
Client, architecture, and installation format
If a download fails or the app will not start after installation, the usual cause is not the configuration itself but a mismatch in operating system, CPU architecture, or package format. The three checks below explain how to narrow it down.
A
First choose a GUI client or core
A GUI client brings subscription management, policy-group selection, system proxy controls, logs, and core settings together for personal computers and phones. Mihomo runs from the command line, with configuration files and service status managed separately, making it better suited to servers, routers, containers, and automation scripts.
If you want to import a subscription and connect immediately, download the GUI for your platform. If you want a gateway to run continuously under file-based control, choose the Mihomo core instead.
B
Then confirm the CPU architecture
Common Windows and Linux desktop labels include x64, x86_64, and AMD64; in this download context, they generally refer to the same 64-bit platform. Apple M-series Macs use ARM64, Intel Macs use x64, and most Android devices use ARM64, while older devices may use 32-bit ARM.
Architecture is separate from the operating system version. Windows 11 does not necessarily mean x64, and macOS runs on both Intel and Apple Silicon, so read the processor name in system information.
C
Finally choose the package format
Windows EXE, macOS DMG, and Android APK are standard installation formats for their platforms. Linux DEB targets Debian-based distributions, RPM targets Fedora, RHEL, and similar distributions, while AppImage runs as a single file. ZIP and GZ packages usually require manual extraction and placement.
Package formats integrate more easily with the desktop; archives are better for manual deployment. Choose based on your system’s software management workflow and maintenance habits.