Download and install the OneXray Xray-core client
OneXray is an open-source Xray-core client for desktop and mobile. It does not include servers or a subscription: obtain a compatible configuration from your provider before connecting. You do not need to install a separate Xray-core command-line program.
After installation, add your servers or generate a configuration with AI. For connectivity problems, check the supported formats before changing platform settings.
Choose your platform
| Platform | Requirements | Downloads |
|---|---|---|
| iPhone / iPad | iOS / iPadOS 15+ | App Store · IPA |
| Mac App Store | macOS 13+, Apple silicon or Intel | App Store |
| Mac — OneXraySE | macOS 13+, Apple silicon or Intel | Homebrew · Universal ZIP |
| Android phones / tablets | Android 10+, arm64-v8a or x86_64 | Google Play · APK |
| Windows x64 | Windows 10 20H2+ | winget · ZIP · Microsoft Store |
| Windows ARM64 | Windows 11 | winget · ZIP · Microsoft Store |
| Linux x86_64 | glibc 2.39+, kernel 5.3+ | DEB · ZIP |
| Linux arm64 | glibc 2.39+, kernel 5.3+ | DEB · ZIP |
See release notes and available assets. Android 32-bit ARM is not supported.
Windows
Install the standalone EXE through winget:
winget install --id YuanDevLLC.OneXray -eEXE and ZIP use a native TUN. Starting VPN requests administrator approval for Core, not for the main app. Extract the entire ZIP before opening OneXray; it does not register links or create shortcuts automatically.
The Microsoft Store edition uses MSIX and Windows system VPN without UAC for Core. EXE/ZIP and MSIX have separate data locations; switching channels is not an in-place data migration. Both require an explicit Xray outbound-interface selection. Windows behavior.
All Windows packages include the matching Microsoft Visual C++ runtime. The GUI does not require a separate runtime installation.
macOS
Mac App Store uses a Packet Tunnel extension. OneXraySE uses a System Extension:
brew install --cask onexrayseFor ZIP, move OneXraySE.app to /Applications before opening it. Complete Setup, enter the main interface, and approve the VPN/Network Extension requests. macOS may direct you to Login Items & Extensions or Privacy & Security; follow any restart prompt. To update the ZIP edition, quit the app, replace it in /Applications, and approve extension updates if requested.
See Apple’s System Extension installation guide.
iOS IPA
The App Store is the simplest option. Sideloading an IPA requires re-signing both the app and its Packet Tunnel extension with profiles that permit Network Extension. A free Personal Team does not provide that capability. See Apple’s supported capabilities.
Linux
On Debian/Ubuntu, the DEB installs dependencies and grants Core its network capabilities:
sudo apt install ./OneXray-linux-x86_64.debUse OneXray-linux-aarch64.deb for arm64. For a ZIP build, run from the directory containing the extracted OneXray folder:
sudo apt install -y procps libcap2-bin libayatana-appindicator3-1
sudo setcap cap_net_admin,cap_net_raw+eip OneXray/OneXrayCoreReapply capabilities if an update replaces Core. ZIP does not register onexray:// links. GNOME may need the AppIndicator extension for tray controls.
Core process monitoring requires Linux kernel 5.3 or newer with pidfd support. On Linux ARM64, Chinese/Japanese/Korean language selections currently display English without changing the saved preference; see language settings.
Continue with first connection.