Guides
Windows & Mac
Connection modes, tray and autostart on desktop.
Connection modes
| Mode | Platforms | What goes through the server |
|---|---|---|
| Full tunnel (TUN) | Windows (default) | All apps — including Telegram and games |
| System proxy | Mac, Linux; Windows if full tunnel is off | Browsers and most apps that respect system proxy |
Full tunnel
Xray creates a Psykotic network adapter (Wintun driver) and routes all traffic through it. The app’s own connections are bound to the physical adapter, so there are no traffic loops. Administrator rights are required — the installed app asks for them on launch. Turn it off in Settings → Desktop connection → Full tunnel.
System proxy
Xray listens on SOCKS 127.0.0.1:10808 and HTTP 127.0.0.1:10809 (free ports are chosen automatically if these are busy), and the app enables the system proxy. No admin rights needed.
Apps that ignore system proxy (Telegram, some games, command-line tools) connect directly. In Telegram you can set SOCKS5 127.0.0.1, port 10808 manually.
On Mac the proxy is applied to all active network services (Wi-Fi, Ethernet). Check it in System Settings → Network → Wi-Fi → Details → Proxies.
Disconnecting
When you disconnect or quit, everything is removed: the proxy is turned off and the tunnel adapter disappears with the Xray process. If the app crashed, the proxy is cleaned up on next launch.
Tray & autostart
- Tray icon (menu bar on Mac): left click opens the window, right click — Open / Connect or Disconnect / Quit
- Closing the window hides it to the tray and keeps the connection
- Launch at login — starts straight to the tray
- Connect on launch — to the last selected server. Together with autostart: turn on the computer and you’re already connected
Logs
The Xray log is stored locally in xray.log: on Mac in ~/Library/Application Support/com.psykotic.app/, on Windows in %APPDATA%\com.psykotic.app\. It never leaves your computer unless you send it to us yourself.