# OneXray — documentation for AI assistants > Configuration and VPN Tunnel documentation for people and AI assistants. OneXray is a client; it supplies no servers or credentials. Language: en-US Read the complete guide before generating a configuration. Choose a server outbound, ordinary Custom Routing, Advanced Custom Routing, or Raw JSON; their import entries and ownership rules differ. Both Custom modes reuse App-selected servers, while Raw JSON supplies its own nodes, routing and DNS. Follow the documented field and platform constraints without silently dropping conditions. VPN Tunnel settings are separate UI operations, not importable JSON fields. Never invent credentials or claim an untested template is a working VPN. ## Complete configuration guide - [Complete configuration and platform guide](https://onexray.com/llms-full.txt): All essential configuration chapters in reading order, including full JSON examples. - [Example manifest](https://onexray.com/examples/manifest.json): Import type, dependencies, and required replacements for each downloadable JSON. ## Essential configuration chapters - [Generate Xray configurations with AI](https://onexray.com/docs/ai/index.md): Use your AI assistant to generate OneXray server, routing or Raw JSON configurations. Copy the prompt, supply server details, then validate and import. - [Supported Xray configuration formats](https://onexray.com/docs/configuration/compatibility/index.md): Check OneXray JSON and share-link support, routing limits and bundled Core requirements before importing a configuration. - [Xray JSON import formats](https://onexray.com/docs/configuration/index.md): Choose server outbound, ordinary or advanced routing, or complete Raw JSON. Learn OneXray import entries, required fields and App-managed settings. - [Xray outbound JSON: server configuration](https://onexray.com/docs/configuration/outbound/index.md): Create a OneXray node JSON with VLESS, VMess, Trojan, Shadowsocks or SOCKS settings. Preserve the server transport, TLS and REALITY parameters. - [Xray routing JSON: ordinary custom rules](https://onexray.com/docs/configuration/custom-routing/index.md): Write importable OneXray routes with empty server slots, ordered domain/IP rules, local DNS, FakeDNS and Geodata dependencies. - [Advanced Xray routing JSON](https://onexray.com/docs/configuration/advanced-routing/index.md): Write Xray routing, DNS, sniffing and local inbounds in JSON while reusing servers from OneXray. Learn the template fields, fixed tags and import steps. - [Fragment routing](https://onexray.com/docs/configuration/fragment/index.md): Enable optional TLS ClientHello fragmentation in Smart and Custom Routing, and understand the template and Raw JSON boundaries. - [Xray Raw JSON configuration contract](https://onexray.com/docs/configuration/raw-json/index.md): Import complete Xray Raw JSON with your own servers, routing and DNS into OneXray. Check required credentials and the Tunnel, log and metrics fields managed by the App. - [Xray DNS, local DNS and FakeDNS](https://onexray.com/docs/configuration/dns/index.md): Configure OneXray route DNS and FakeDNS. Understand proxy versus direct resolution, internal domains, IPv6 policy and the separate TUN DNS settings. - [GeoIP and Geosite dependencies for routing](https://onexray.com/docs/configuration/geodata/index.md): Use actual GeoIP and Geosite categories in OneXray rules. Declare custom DAT downloads and handle missing files without inventing region names. - [Configuration recipes](https://onexray.com/docs/recipes/index.md): Complete examples for regional routing, corporate DNS, multiple proxy paths, protocol matching and FakeDNS. - [Smart Routing](https://onexray.com/docs/connect/smart-routing/index.md): Configure a direct region, a custom local DNS address, service bypass, entry-node count, and an optional final exit. - [VPN Tunnel settings by platform and task](https://onexray.com/docs/tunnel-guide/index.md): Find OneXray settings for per-app VPN, Wi-Fi automation, excluded networks, DNS and outbound adapters. Choose the controls supported by your device and package. - [Troubleshoot Xray imports, DNS and VPN connections](https://onexray.com/docs/troubleshooting/index.md): Diagnose OneXray JSON import errors, missing Geodata, DNS failures and VPN startup problems. Identify the failing step without mistaking a valid file for a working connection. - [Xray TUN mode and VPN Tunnel settings](https://onexray.com/docs/advanced/vpn-tunnel/index.md): Set OneXray tunnel DNS, IPv6 and the Windows/Linux outbound interface. Understand what TUN mode does and which options depend on your platform. - [Apple system VPN](https://onexray.com/docs/advanced/apple/index.md): Configure Apple VPN on-demand rules, traffic-capture exclusions, and VPN icon hiding on iOS/iPadOS, with platform limits and network-switching guidance. - [Android system VPN](https://onexray.com/docs/advanced/android/index.md): Configure Android per-app routing or control the VPN in the background with token-authenticated Tasker, MacroDroid, and Automate broadcasts. - [Windows VPN modes](https://onexray.com/docs/advanced/windows/index.md): Compare Windows EXE/ZIP native TUN and Microsoft Store MSIX system VPN, including UAC, interfaces, startup, and quitting. - [LAN proxy sharing](https://onexray.com/docs/advanced/lan-proxy/index.md): Use an optional HTTP and SOCKS5 listener on a trusted network, with explicit startup, routing, Raw JSON and Apple platform limitations. - [Import and sharing formats](https://onexray.com/docs/sharing/index.md): Understand standard share links, OneXray URLs, complete JSON, and GeoData dependencies without sharing private age keys. - [Backup & restore](https://onexray.com/docs/backup/index.md): Back up connection configurations to one replaceable file using iCloud, Android's system file picker, or a OneDrive folder. Restore without waiting for GeoData downloads. - [Local configuration HTTP API](https://onexray.com/docs/advanced/local-api/index.md): Validate OneXray JSON and generate runtime previews through the desktop app's authenticated loopback HTTP API. ## Other public documentation - [Documentation](https://onexray.com/docs/index.md): Generate importable OneXray JSON with AI, understand configuration contracts, and configure your platform VPN. - [Advanced](https://onexray.com/docs/advanced/index.md): Manage platform VPN settings, routing data, update schedules, latency tests, logs, and the generated Xray configuration. - [Data updates](https://onexray.com/docs/advanced/data-updates/index.md): Configure global subscription and GeoData update schedules, independent of App version updates. - [Routing data](https://onexray.com/docs/advanced/geodata/index.md): Manage default GeoSite/GeoIP together and add custom HTTPS GeoData sources with explicit file names. - [Latency tests](https://onexray.com/docs/advanced/latency/index.md): Set a test URL, timeout and optional exit-region detection; understand VPN accuracy warnings, queued tests and cancellation. - [Logs and generated configuration](https://onexray.com/docs/advanced/logs/index.md): View separate Xray access/error logs and the actual generated configuration; understand local-only logging and OneXraySE limits. - [Connect](https://onexray.com/docs/connect/index.md): Choose servers and a traffic method, or use expert-mode Raw JSON. Understand live traffic and reconnect behavior. - [Custom Routing](https://onexray.com/docs/connect/custom-routing/index.md): Custom Routing — Import and sharing - [Raw JSON](https://onexray.com/docs/connect/raw-json/index.md): Raw JSON — Import and sharing - [Credits and licenses](https://onexray.com/docs/credits/index.md): Open-source foundations of OneXray, including Xray-core, libXray, Vole, Flutter, routing data, and Wintun distribution references. - [Development](https://onexray.com/docs/develop/index.md): Find the current OneXray App setup, architecture contracts, build scripts, and contribution entry points. - [First connection](https://onexray.com/docs/getting-started/index.md): Choose a direct region and the required outbound interface together, authorize on entering Home, then add or restore configurations and connect. - [Download and install the OneXray Xray-core client](https://onexray.com/docs/install/index.md): Install OneXray from App Store, Google Play or Microsoft Store. Also available via winget and standalone packages for Windows, macOS, Linux, iOS and Android. - [Privacy policy](https://onexray.com/docs/privacy/index.md): How OneXray processes local configurations, optional logs, installed-app lists, and network requests without an analytics backend. - [Xray proxy protocols and transports](https://onexray.com/docs/protocols/index.md): Choose the right OneXray import for VLESS, VMessAEAD, Trojan, Shadowsocks or SOCKS, and understand XHTTP, TLS, REALITY and Vision. - [VLESS client setup: TLS, REALITY and Vision](https://onexray.com/docs/protocols/vless/index.md): Import a VLESS server into OneXray with the correct UUID, transport, TLS or REALITY settings. Understand when the provider requires Vision. - [VMessAEAD client and JSON import](https://onexray.com/docs/protocols/vmess/index.md): Import VMessAEAD links or native VMess outbound JSON into OneXray. Preserve WebSocket/TLS settings and distinguish legacy VMess QR-code data. - [XHTTP client setup with OneXray](https://onexray.com/docs/protocols/xhttp/index.md): Use XHTTP transport with your OneXray server. Match the provider's host, path, mode, security and extra settings before importing. - [Servers](https://onexray.com/docs/servers/index.md): Manage servers by subscription or detected location, inspect latency and protocol labels, and apply groups to your connection. - [Add servers](https://onexray.com/docs/servers/import/index.md): Import links, subscriptions, node JSON, files, and QR codes into OneXray without a second node confirmation. - [Subscriptions, HWID, and age](https://onexray.com/docs/servers/subscriptions/index.md): Add HTTPS subscriptions, configure optional HWID and age encryption, and understand identifier and sharing boundaries. - [Settings](https://onexray.com/docs/settings/index.md): Manage appearance, language, startup, download identity, configuration backup, updates, and local data. - [Shortcuts and system menus](https://onexray.com/docs/shortcuts/index.md): Four mobile app-icon shortcuts and desktop tray actions for VPN, server selection, and data updates. - [Updates and upgrading](https://onexray.com/docs/upgrading/index.md): OneXray 26.10.2 adds Fragment routing, optional LAN proxy sharing, Android VPN automation and updated Windows system-VPN integration.