Platform Support#

Platform Minimum system Distribution Download
iOS iOS 15 App Store, IPA App Store, IPA
macOS (Mac App Store) macOS 12 Mac App Store App Store
macOS (Outside App Store) macOS 12 Homebrew, ZIP Homebrew: brew install --cask onexrayse
Universal ZIP
Android Android 10 Google Play, APK Google Play, Universal APK
Windows x86_64 Windows 10 winget, EXE, ZIP winget: winget install --id YuanDevLLC.OneXray -e
EXE, ZIP
Linux x86_64 glibc 2.39 DEB, ZIP DEB, ZIP
Linux arm64 glibc 2.39 DEB, ZIP DEB, ZIP

OneXray bundles Xray-core and the platform network integration required by the app. The VPN is started and stopped from the app UI.

macOS Outside App Store#

The Homebrew cask token is onexrayse.

Homebrew installs the same Developer ID macos_se package as OneXray-macos-universal.zip, and the app bundle is OneXraySE.app. The Mac App Store version is a separate store package.

brew install --cask onexrayse
brew uninstall --cask onexrayse

Windows winget#

Install or uninstall OneXray with winget:

winget install --id YuanDevLLC.OneXray -e
winget uninstall --id YuanDevLLC.OneXray -e

Linux ZIP#

Install runtime dependencies:

sudo apt install -y procps libcap2-bin libayatana-appindicator3-1

Grant the core binary the capability required to create and operate the TUN device:

sudo setcap cap_net_admin,cap_net_raw+eip OneXray/bin/OneXrayCore

GNOME users may need an AppIndicator extension to show the tray icon.

Linux DEB#

Install:

sudo apt install ./OneXray-linux-x86_64.deb

Remove:

sudo apt remove onexray