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

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

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

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.

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.