Settings
Settings contains app preferences rather than VPN tunnel or Xray runtime settings.
Appearance and language
Theme and language follow the system on first installation. You can choose light/dark appearance or a supported language explicitly:
- English
- Simplified Chinese
- Traditional Chinese
- Russian
- Persian, with right-to-left layout
Unsupported system languages fall back to English. JSON, URLs, IPs, and logs keep left-to-right layout. Apple editions expose app-icon choices where supported.
On Linux ARM64, Chinese, Japanese, and Korean language selections currently render the interface in English to avoid a font/rendering issue. The saved language preference is retained. This fallback does not apply to Linux x86_64 or other platforms.
OneXray follows the system’s reduced-motion preference. Switches, selection feedback and JSON-assistance scrolling move directly to their result when motion is reduced. Connection preparation keeps its status text, static loading indicator and cancellation action. There is no separate App animation switch.
Startup
Connect when the app opens is separate from desktop launch at login and start hidden. All default to off.
Closing a desktop window hides it. On macOS/MSIX, use Quit and Stop VPN when you want to disconnect as well as exit; EXE/ZIP and Linux Quit stop VPN first.
On macOS, the native title bar supports dragging and the system-configured double-click action, including zoom/restore. Reopening a minimized desktop window restores it before focusing it; closing still hides it. Linux uses the system title bar and window buttons on Wayland and X11; moving, resizing and maximizing follow the desktop environment. Its tray menu is opened by the desktop panel. The App keeps Skia rendering for compatibility with Mesa SVGA3D display drivers.
Download identity
Downloads use a compatible default, v2rayN/<OneXray version> <full OneXray User-Agent>, including version and platform information. Each subscription has its own optional User-Agent field; a custom value overrides only that source. Clearing it uses the default. There is no global User-Agent selector.
Version and support
About shows the App version, update information, and support links. The About section also displays the Xray-core version. An available app update adds a dot to About; desktop navigation also shows a reminder. There is no separate Check App updates row on Settings.
Subscription and GeoData schedules are under Xray > Data updates.
See shortcuts and system menus for mobile quick actions and desktop tray controls.
Backup & restore
The Data section opens Backup & restore: iCloud Drive or a selected file on Apple, a system-selected file on Android, or a OneDrive-synced folder on Windows. OneXray binds one replaceable configuration file. Linux does not expose this entry.
Automatic backup defaults to on. Binding an empty file or choosing overwrite writes the first backup even when it is off; an existing file can instead be restored after preview. Later automatic writes use their own 1/3/7-day interval, defaulting to 3 days, independently of GeoData. Backups are unencrypted and can contain credentials and Age private keys; keep them private.
Clear data
Settings offers two separate actions:
- Clear connection resources removes nodes, personal Raw, subscriptions, manual groups, custom routes and custom GeoData, plus saved connection choices and old runtime files/logs. App preferences, platform VPN/dialing/interface settings, backup binding and external-access permissions are kept.
- Clear all app data additionally resets connection/startup/update/backup settings, unbinds backup and revokes Local API/Android automation access. It recreates default routing data. Theme, language, app icon, Dock visibility, privacy/setup completion and system permissions are retained.
Both confirm and stop VPN before replacing data; a failed stop prevents deletion. Neither restarts Setup or automatically connects afterward. External backup files and provider-side HWID records are not deleted. Back up required connection assets first; backup scope does not include every preference or file.
Navigation and editing
Pages use icons and clear primary labels, with less repeated guidance and consistent card and row spacing. Current values, subscription allowances, traffic, latency and runtime state remain visible; input errors and the consequences of destructive or reconnect actions are still explained where needed.
On macOS, use Settings… in the app menu or ⌘, to open Settings and restore a hidden/minimized main window. An open dialog is brought forward without discarding its draft. The left navigation remains on wide screens, while pages use one content column. Rule lists, details and editors open as full pages. App bars show the page title and contextual actions; theme selection is in Settings.
Accessible controls retain meaningful names and usable touch areas. Subscription, latency and tunnel DNS fields keep errors near the input after validation, preserving the draft for correction. Closing a changed node-JSON editor asks whether to keep editing or discard; successful saving closes normally. Backup & restore includes the matching platform’s migratable VPN settings, while physical interfaces, permissions and app preferences stay local.