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.

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.

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 Advanced > 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

Clear data stops VPN before deleting application configuration, subscriptions, custom routing data, and preferences, then recreates default routing data. A failed stop prevents deletion. Privacy/setup completion is not reset.

This is destructive. Back up connection configurations or export individual items you need beforehand; backup does not include files, permissions or general app preferences. External backup files are not deleted by clearing app data. Clearing data also removes local subscription HWIDs; it does not remove a provider’s device records. See subscription HWID before recreating a device-limited subscription.

Navigation and editing

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. On wide screens, routing sections use the available columns; ordinary rule lists and rule editing share equal-width panes.

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.