Skip to main content

Getting Started


Installing throne is easy! You'll need a couple prerequisites to install today.

  • Git
  • Python >= 3.6
  • Pip (for python3) >= 9.0.3

Prerequisite Install

sudo yum install -y git python3 python3-pip

Additionally, if you're running CentOS 8+ you can install using dnf:

sudo dnf install -y git python3 python3-pip

Throne Installation

You can install throne from PyPi using the command below.

pip install throne
Installing from PyPi

When installing throne from PyPi to a WSL machine, you may need to add /home/$USER/local/.bin to your path variable. This can be done by doing export PATH="/home/$USER/local/.bin:$PATH". Make sure to replace $USER with the username you're installing under on your system. Your system may not have the $USER variable set.


You've officially installed throne! It can now be executed just by running throne from the CLI.

[user@throne ~] throne
Usage: throne [OPTIONS] COMMAND [ARGS]...

Throne is a command line tool to query various things on the internet.

-v, --verbose Enables verbose mode.
--help Show this message and exit.

api Retrieve API keys from the throne API
bgp Retrieve BGP related information.
ip Retrieve IP related information.
pdb Retrieve information from PeeringDB.
shodan Retrieve information from Shodan.
whois Retrieve WHOIS information on domains.