OneXray

An open-source Xray-core client for phones, tablets and desktops.

English · 简体中文 · Русский

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.

Why OneXray

• 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.

Get started

1. Install from the official store and complete setup and system permissions. Windows and Linux also need an outbound-interface selection.
2. Open Servers and add your subscription, share links or Xray JSON. Complete provider configurations are recognized during subscription import.
3. 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

Download

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).

Linux

DEB · x86_64 · DEB · arm64. Requires Linux 5.3+ and glibc 2.39+. See the Linux installation guide for dependencies and permissions.

OneXraySE

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.

Other downloads

Configuration and help

• 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.

Support OneXray

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.

License

GNU General Public License v3.0.