An open-source Xray-core client for phones, tablets and desktops.
Download from the official stores
System requirements · Linux · OneXraySE · Other downloads
If OneXray is useful to you, give this repository a ⭐ Star to support its continued development.
Bring your own servers or subscription. OneXray does not provide VPN access or proxy servers.
- Across your devices. Use iPhone, iPad, Mac, Android, Windows or Linux, with light/dark themes and five interface languages.
- Your servers, organized. Import share links, Xray JSON and subscriptions. Group manual nodes and reorder them by dragging.
- Routing you control. Choose Smart or Custom Routing, or use complete Raw and provider configurations, including Remnawave subscriptions.
- Open and private. GPL-3.0 source with a VPN provider exception, without accounts, advertising, analytics or tracking. Privacy policy.
The current official packages require the following operating systems and architectures:
| Platform | Minimum operating system | Supported architectures |
|---|---|---|
| iPhone / iPad | iOS / iPadOS 16 | arm64 |
| macOS (Mac App Store) | macOS 13 | Apple silicon (arm64), Intel (x86_64) |
| macOS (OneXraySE) | macOS 13 | Apple silicon (arm64), Intel (x86_64) |
| Android | Android 10 (API 29) | arm64-v8a, x86_64; 32-bit devices are not supported |
| Windows x64 | Windows 10 20H2 (build 19042) | x64 (x86_64) |
| Windows ARM64 | Windows 11 | ARM64 |
| Linux (DEB / ZIP) | Ubuntu 24.04 LTS or compatible distributions, with Linux kernel 5.3+, glibc 2.39+, GLib 2.80+ and the GTK 3 runtime | x86_64, arm64 |
Ubuntu 22.04's system GLib 2.72 does not meet the current official DEB / ZIP requirements. Use Ubuntu 24.04 LTS or another distribution that meets all the requirements above.
See the system requirements guide for details.
- Install from the official store and complete setup and system permissions. Windows and Linux also need an outbound-interface selection.
- Open Servers and add your subscription, share links or Xray JSON. Complete provider configurations are recognized during subscription import.
- On Connect, choose a server or complete configuration and start the VPN. For App-managed nodes, Smart Routing is a useful starting point; provider configurations use their own routing and DNS.
First connection guide · Import guide · Remnawave guide
Check the system requirements, then choose the official store for your device:
- iPhone / iPad: App Store.
- macOS: Mac App Store.
- Android phones / tablets: Google Play.
- Windows: Microsoft Store.
DEB · x86_64 · DEB · arm64. Check the Linux system requirements and see the Linux installation guide for dependencies and permissions.
The macOS System Extension edition is available through Homebrew or Universal ZIP. Check the system requirements and follow the macOS installation guide for extension approval and updates.
Direct packages and installation details
| Platform | Packages |
|---|---|
| iPhone / iPad | IPA |
| Android | Universal APK |
| Windows x64 | EXE via winget · ZIP |
| Windows ARM64 | EXE via winget · ZIP |
| Linux x86_64 | ZIP |
| Linux arm64 | ZIP |
The installation guide covers IPA signing, Windows editions and separate data locations, ZIP permissions and updates. All releases.
- User documentation — setup, routing, subscriptions and platform features.
- Configure with AI — copy the guide's prompt into an assistant you trust, or attach the complete guide. OneXray has no built-in AI service and does not send configurations to an assistant; review generated JSON in the App before connecting.
- Report a bug or request a feature — include your platform, App/Core versions and reproduction steps. Remove credentials from shared configurations, subscription links and logs.
- Telegram community.
Enjoy OneXray? Give this repository a ⭐ Star to support its continued development.
App Store · Google Play · Microsoft Store
Code, translations and documentation contributions are welcome. Start with the development setup, build guide and App contracts.
OneXray is licensed under the GNU General Public License v3.0, with the OneXray VPN Provider Exception.
VPN service providers may build and distribute dedicated, customized closed-source clients that connect exclusively to their own VPN services without complying with the repository's GPL requirements for the code covered by the exception.
To qualify, the client must not include general-purpose custom-configuration or subscription features, including the ability to import or use arbitrary third-party VPN or proxy configurations or subscription URLs. Configurations and subscriptions supplied by the provider solely for access to its own VPN service are permitted. Branding the client for the provider, distributing it only to the provider's subscribers, or making the provider's service the default is not sufficient if the client can also connect to third-party services.
Each closed-source client distributed under this exception must clearly acknowledge that it is based on the OneXray project and include a link to OneXray in a reasonably accessible part of its user interface, such as an About, Credits or Open-source Notices screen.
These conditions apply to eligibility for the exception. Other uses remain subject to the GPL or another applicable permission.
Yuan Dev Team guarantees that it will not introduce direct third-party dependencies that require a qualifying customized client as a whole to be GPL-licensed or to disclose its source code under the GPL. Third-party licenses and their component-specific obligations still apply; the exception only covers rights Yuan Dev Team owns or is authorized to license.
For business partnerships, please email yuan@yuandev.net.