Quick Start
Add your servers, test them, choose a routing profile and connect with Throne on Windows, Linux or macOS.
You need a subscription link or a share link from your provider, or the details of your own server. Every step here works in Simple mode, which a new installation starts in. For Android, see Throne for Android.
Add servers
Throne stores each server as a profile. Profiles belong to groups, the tabs above the profile list. A subscription is a group that Throne downloads from a URL and can update later.
Add a subscription
- Copy the subscription URL. It starts with
https://. - In the main window, press
Ctrl+V(orProgram→Add profile from clipboard). - Choose
Create new subscription groupand clickOK.
Throne creates a group named after the host in the URL and downloads its profiles. If your provider sends plan details, a card above the profile list shows your used traffic and expiry date. Add profiles to this group would import the profiles only once, without the URL, so they cannot be updated.
Update the current group later with Groups → Update subscription (Ctrl+U). For automatic updates, see Subscriptions & Groups.
Add single profiles
Profiles go into the group whose tab is selected.
- Share links such as
vless://,ss://ortrojan://: copy one or more, one per line, and pressCtrl+V. - A QR code on your screen:
Program→Scan QR Code(Ctrl+Shift+Q). - Files and QR code images: drag them onto the main window, or
Program→Add profile from File(s)(Ctrl+O). - By hand:
Program→New profile(Ctrl+N).
All supported links and files are listed in Protocols & Import Formats.
Test servers
Click Groups → Url Test Group (Ctrl+Shift+G) to measure the delay of every profile in the group. To test only some, select them, right-click and choose Url Test Selected (Ctrl+Shift+S).
The Test Result column shows the delay in milliseconds, or Unavailable. Click its header to sort. Groups → Clean up → Remove Unavailable (Ctrl+Shift+R) deletes the failed profiles; a subscription update adds them again if the provider still lists them.
For speed tests and automatic server choice, see Testing & Auto Selector.
Choose routing
This step is optional: the built-in Default routing profile sends all traffic through the proxy. To open the websites of your own country directly:
- Click
Routing→Download Profilesand chooseChina,IranorRussia. KeepAuto updateticked and clickOK. - Open the
Routingmenu again and chooseBypass China,Bypass IranorBypass Russiaat the bottom. A running profile restarts with the new routing.
A "Bypass" profile proxies everything except the websites and IP addresses of that country and your local network. For the other downloaded profiles and your own rules, see Routing.
Connect
- Click the profile that you want to use.
- Press
Enter, or click the Start button to the right ofTools. - Tick
System ProxyorTun Mode, next to the Start button.
| Mode | What it does |
|---|---|
System Proxy |
Points the proxy settings of your system to Throne (127.0.0.1:2080 by default). Browsers and other apps that follow these settings use the proxy. |
Tun Mode |
Captures the traffic of all apps, including apps that ignore proxy settings. Needs administrator or root rights. |
You can turn on both. With neither, apps that you set up yourself can still use Throne as a SOCKS5 or HTTP proxy at 127.0.0.1:2080. See Which mode to use.
The first time you tick Tun Mode, Throne asks for the rights it needs. Click Yes, then:
- Windows: confirm the Windows prompt. Throne restarts as administrator with
Tun Modeon. If Windows Firewall asks aboutThroneCore, allow it. - Linux: enter your password, then tick
Tun Modeagain. - macOS: enter your password in the Terminal window that opens, then tick
Tun Modeagain.
See TUN privileges for details.
Check the connection
The bottom left corner of the window shows the running profile and, a moment later, the country and city of your exit IP address. Click it to test the connection: Test Result: <n> ms means it works. If you see Unavailable, try another profile or see Troubleshooting.
Stop and quit
- To disconnect, click the Start button again (now
Stop), or pressCtrl+S. - Closing the window only hides Throne in the tray. To quit, use
Program→ExitorExitin the tray menu. Program→Remember last profilereconnects when Throne starts, andProgram→Start with systemstarts Throne when you log in.
Simple and Advanced mode
Simple mode shows the options most people need and hides advanced menu items, settings and tabs, such as Preset Settings, the Logging and Core tabs of Basic Settings, most DNS options and the advanced options of the profile editor. Advanced mode shows everything. A new installation starts in Simple mode; an updated one keeps Advanced mode.
Hidden settings keep their values and still apply, so switching the mode changes nothing else. To switch, open Settings → Basic Settings → Style, set Interface to Simple or Advanced and click OK.
To find any setting, press Ctrl+K and type part of its name. In Simple mode, this also finds hidden settings; choosing one switches to Advanced mode and opens it. See Command palette.
In Simple mode, some tabs that these docs name are sections of another tab. For example, the Subscription and Security tabs of Basic Settings, and the Warp tab of Routing Settings, are sections of their Common tab.
Next steps
- Subscriptions & Groups: automatic updates, and the User-Agent and HWID settings that some providers need.
- Routing: your own rules, for example to send only a few websites through the proxy.
- Testing & Auto Selector: speed tests, and automatic switching to a working server.
- TUN Mode and DNS: settings, side effects and leak tests.
- Troubleshooting and FAQ: help when something does not work.