Installation

Install Throne on Windows, macOS or Linux, keep it up to date, or build it from source.

Get the files from Downloads. For Android, see Installation & Upgrade.

Windows

Your computer File
Any Windows PC, if you are not sure Throne-<version>-windows-universal-installer.exe
Windows 10 1809 or newer, x64 Throne-<version>-windows64.zip
Windows on ARM64 Throne-<version>-windows-arm64.zip
Windows 7 SP1 to Windows 10 1803 (x64), or a processor without SSE4.2 Throne-<version>-windowslegacy64.zip
32-bit (x86) Windows 7 SP1 or newer Throne-<version>-windows32.zip

Installer

The universal installer picks the right build for your PC and installs it into %LOCALAPPDATA%\Throne, without administrator rights. Your data is kept in its config folder. If you install for all users into Program Files instead, Throne keeps your data in %LOCALAPPDATA%\Throne\config and cannot update itself.

To uninstall, remove Throne in the installed apps of Windows. It asks whether to delete your profiles and settings too.

Portable ZIP

Extract the ZIP to a folder you can write to and run Throne.exe from the Throne folder. Your data is kept in the config folder next to it, so you can move or back up the whole folder.

Unlike the installer, a ZIP copy does not open throne:// links until you tick Settings → Basic Settings → Common → Register throne:// links at startup (Advanced mode only, see Simple and Advanced mode).

macOS

Your Mac File
Apple Silicon, macOS 14.4 or newer Throne-<version>-macos-arm64.zip
Intel, macOS 14.4 or newer Throne-<version>-macos-amd64.zip
Intel, macOS 10.15 to 14.3 Throne-<version>-macoslegacy-amd64.zip

Install the ZIP like this, or use Homebrew, which does it for you:

  1. Extract the ZIP and move Throne.app to /Applications before you open it the first time. From ~/Downloads, Throne can fail to get the rights it needs for TUN mode.

  2. Throne is not signed by Apple, so remove the quarantine flag, or macOS says it "is damaged and can't be opened":

    xattr -d com.apple.quarantine /Applications/Throne.app
    
  3. Open Throne.

Your data is kept in your user folder, so you can replace Throne.app without losing your profiles. TUN mode needs an administrator account; see TUN Mode.

Linux

File Use it for
Install script Any distribution. Installs the ZIP build to /opt/Throne.
Throne-<version>-linux-amd64.zip, …-linux-arm64.zip A portable copy in a folder of your choice
Throne-<version>-debian-amd64.deb, …-debian-arm64.deb Debian, Ubuntu, Linux Mint and other Debian-based systems
Throne-<version>-fedora-amd64.rpm, …-fedora-arm64.rpm Fedora and RHEL-based systems
Files that end in -system-qt.deb or -system-qt.rpm The same packages, using the Qt of your system
APT repository and RPM repository The system-Qt packages, kept up to date by your package manager

The ZIP, the install script and the normal packages include their own copy of Qt and need glibc 2.28 or newer: Debian 10, Ubuntu 20.04, RHEL 8 (and AlmaLinux or Rocky Linux 8), Raspberry Pi OS (64-bit) bullseye or newer. The -system-qt packages use the Qt 6 of your distribution and need glibc 2.34 or newer, for example Debian 12 or Ubuntu 22.04. Use them when the normal package does not start, for example on an old processor, or when you want the Qt theme of your desktop.

Install script

The script needs Python 3:

curl -fsSL https://raw.githubusercontent.com/throneproj/Throne/dev/script/install_linux.py | sudo python3

Choose Install and the branch (Stable or Unstable), or Uninstall. Run the same command again to update or uninstall. Uninstalling keeps your settings in ~/.config/Throne.

Portable ZIP

unzip Throne-x.x.x-linux-amd64.zip
cd Throne
./Throne

Your data is kept in the config folder inside Throne.

Debian and Ubuntu (.deb)

sudo apt install ./Throne-x.x.x-debian-amd64.deb

Fedora and RHEL (.rpm)

sudo dnf install ./Throne-x.x.x-fedora-amd64.rpm

Both packages install Throne to /opt/Throne and keep your data in ~/.config/Throne. To get updates through your package manager, use a repository instead.

APT repository

The signed APT repository has the system-Qt packages of every stable release for amd64 and arm64. It needs Debian 12, Ubuntu 22.04 or newer; on older systems, use the normal .deb.

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSLo /etc/apt/keyrings/throne.asc https://throneproj.github.io/Throne/throne.asc
sudo curl -fsSLo /etc/apt/sources.list.d/throne.list https://throneproj.github.io/Throne/apt/throne.list
sudo apt update
sudo apt install throne

After that, sudo apt upgrade also updates Throne.

RPM repository

The signed RPM repository has the system-Qt packages of every stable release for x86_64 and aarch64. They need Qt 6.5 and glibc 2.34 or newer, so on RHEL 8 and its rebuilds, use the normal .rpm.

Fedora and RHEL 9 or newer:

sudo curl -fsSLo /etc/yum.repos.d/throne.repo https://throneproj.github.io/Throne/rpm/throne.repo
sudo dnf install throne --refresh

openSUSE and SLES:

sudo zypper addrepo -fc https://throneproj.github.io/Throne/rpm/throne.repo
sudo zypper install throne

The first time, dnf and zypper ask you to trust the signing key.

Package managers

WinGet

winget install -e --id Throneproj.Throne

Scoop

scoop bucket add extras
scoop install extras/throne

Homebrew

brew install --cask throneproj/tap/throne

The official tap gets every stable release. The cask installs Throne.app to /Applications, removes the quarantine flag and needs macOS 14.4 or newer; on older Intel Macs, use the macoslegacy ZIP. Always use the full name: brew install --cask throne does not find Throne.

Update with brew upgrade --cask throne; Throne then asks again for the rights it needs for TUN mode. brew uninstall --zap --cask throne also deletes your data in ~/Library/Preferences/Throne.

Arch Linux (AUR)

Install throne with an AUR helper, for example yay -S throne or paru -S throne. The package builds Throne from source, installs it to /usr/lib/throne and gets every stable release. Your data is kept in ~/.config/Throne.

Nix

On NixOS, add this to your configuration:

programs.throne = {
  enable = true;
  tunMode.enable = true; # optional, needed for TUN mode
};

Or install it with nix-env. The channel is usually nixos on NixOS and nixpkgs on other distributions:

nix-env -iA nixos.throne

To try Throne without installing it, run nix-shell -p throne.

Build from source

Throne has two parts: the interface (Throne, C++ and Qt) and the core (ThroneCore, Go). The core must be next to the Throne executable.

Part Requirements
Interface CMake 3.20 or newer, a C++20 compiler, Qt 6.2 or newer (Widgets, Network, LinguistTools, and DBus on Linux), X11 and xcb development headers on Linux
Core Go 1.26 or newer, protoc, protoc-gen-go and protoc-gen-go-grpc. CGO: on Linux the Chromium toolchain from cronet-go (for NaïveProxy), on macOS the Xcode command line tools.

Build the interface. It needs srslist.h, the list of rule-set names, in the build folder:

git clone https://github.com/throneproj/Throne.git ~/Throne
cd ~/Throne
mkdir build
cd build
curl -fLso srslist.h https://raw.githubusercontent.com/throneproj/routeprofiles/rule-set/srslist.h
cmake -GNinja -DCMAKE_BUILD_TYPE=Release ..
ninja

Then build the core with script/build_go.sh and copy it next to the interface. On Linux, set up the cronet-go toolchain in the same terminal first. build_go.sh deletes the DEST folder before it builds, so give it a folder of its own:

cd ~/Throne
GOOS=linux GOARCH=amd64 DEST="$PWD/deployment/linux-amd64" ./script/build_go.sh
cp deployment/linux-amd64/ThroneCore build/

On macOS, add -DNKR_PACKAGE_MACOS=1 to cmake, build the core with GOOS=darwin and copy ThroneCore into Throne.app/Contents/MacOS/. The exact steps for every platform, including the cronet-go toolchain, the protobuf plugin versions, Windows and the legacy builds, are in .github/workflows/build.yml in the Throne repository.

Updating

Windows and Linux ZIP copies, and per-user installations from the Windows installer, update themselves: Program → Check For Update, then Update. If a headless Throne runs from the same installation, stop it first. Update other copies the way you installed them: run the new installer, install the new package, run the install script again, replace Throne.app on macOS, or use your package manager. Your profiles and settings stay.

After an update on Linux or macOS, Throne may ask again for the rights it needs for TUN mode. For beta versions and backups, see Backup, Updates & Migration.

Troubleshooting

If Throne does not start or shows an error after installation, see Startup and desktop problems. If your antivirus flags Throne, see the FAQ.