Platform Support#
| Platform | Minimum system | Distribution | Download |
|---|---|---|---|
| iOS | iOS 15 | App Store, IPA | App Store, IPA |
| macOS | macOS 12 | Mac App Store, ZIP | Mac App Store, Universal ZIP |
| Android | Android 10 | Google Play, APK | Google Play, Universal APK |
| Windows x86_64 | Windows 10 | EXE, ZIP | 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 normally started from the app. Desktop builds also include a CLI that controls the running app through a local Automation API.
Linux ZIP#
Install runtime dependencies:
sudo apt install -y procps libcap2-bin libayatana-appindicator3-1Grant the core binary the capability required to create and operate the TUN device:
sudo setcap cap_net_admin,cap_net_raw+eip OneXray/bin/OneXrayCoreGNOME users may need an AppIndicator extension to show the tray icon.
Linux DEB#
Install:
sudo apt install ./OneXray-linux-x86_64.debRemove:
sudo apt remove onexrayDesktop CLI#
Desktop packages include the onexray CLI. The app must be open before CLI commands can work.
onexray health
onexray status
onexray import --file /path/to/import.txt
onexray import --text 'vless://...'See Develop for the full CLI and API contract.