An open-source Xray-core client for phones, tablets and desktops.
Download from the official stores
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, without accounts, advertising, analytics or tracking. Privacy policy.
- 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
Choose the official store for your device:
- iPhone / iPad: App Store — iOS / iPadOS 15+.
- macOS: Mac App Store — macOS 13+, Apple silicon or Intel.
- Android phones / tablets: Google Play — Android 10+, arm64-v8a or x86_64.
- Windows: Microsoft Store — Windows 10 20H2+ (x64) or Windows 11 (ARM64).
DEB · x86_64 · DEB · arm64. Requires Linux 5.3+ and glibc 2.39+. See the Linux installation guide for dependencies and permissions.
The macOS System Extension edition is available through Homebrew or Universal ZIP. Requires macOS 13+, Apple silicon or Intel. 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.