How To: Host Your Own Tor Hidden Service with a Custom Onion Address

Host Your Own Tor Hidden Service with a Custom Onion Address

A mention of the deep web can bring to mind images of drugs, hackers, and other criminal activity. Despite the presence of these elements, the Tor network is a valuable tool for preserving privacy and anonymity. Browsing the deep web and any hidden services can be as simple as downloading the Tor Browser Bundle. In this guide, we will learn how easy it is to host our own hidden services and make them accessible via a custom onion address.

Step 1: Understanding How the Tor Network Works

Accessing the internet directly without a proxy, VPN, or other privacy service relays information in a relatively linear fashion. A device attached to the internet via a router follows a series of lookup requests for a specific URL or IP address and returns the content to the device which requested the information.

The contents of the transmission may be encrypted using HTTPS, SSL, or another form of encryption, but the requests are still directly connected to IP addresses on each end of the transaction and carried in a way which can be analyzed by an internet service provider (ISP). In short, your ISP can see where you go on the web.

Simplified visualization of standard traffic. Image by TAKHION/Null Byte

While the Tor network doesn't entirely bypass an internet service provider in the way a meshnet could, it does utilize a unique method of obfuscating traffic. Rather than directly requesting a webpage or other data by directly addressing a server by its IP, traffic routed over Tor sends the encrypted details of its requests to an entrance node from a list of retrieved nodes within the Tor network first.

That traffic is then carried over several more hops to different nodes in the Tor network, before either reaching its destination within the Tor network or being carried back into the internet through an exit node.

Visualization of Tor-style routing. Image by TAKHION/Null Byte

Unfortunately, this entrance back into the internet from the Tor network poses a security and privacy risk. The content passed over the exit node is subject to the trustworthiness of the node itself, as the node has the same level of access to the details of a request as an ISP would. If the data is not encrypted at this point, it is subject to being captured and used maliciously, as demonstrated by chloe in BADONIONS.

To avoid the danger of using exit nodes, we can instead access or host a website which is accessible only and entirely through the Tor network, in the form of a hidden service. Rather than requesting a URL or IP address, the service will be accessible only through an "onion" address, which can only be discovered by its name within the Tor network.

Step 2: Browsing Hidden Services

The Tor Browser Bundle is available from the Tor Project's website for Windows, macOS, and Linux/Unix systems. Once installed, you can open the browser, and it will automatically connect to the Tor network.

We can view our route through the Tor network by clicking the drop-down arrow next to the onion icon in the upper left of the window. In the case of visiting a .onion site, we can only see the last relays and the "Onion site" listed in the circuit information.

If you need more information on using the Tor browser, you can check out our guide on it linked below.

Step 3: Hosting a Server

The first step in configuring a Tor server will be setting up a way to serve HTTP content, just the same as a regular web server might. While we might choose to run a conventional web server at so that it becomes accessible to the internet as a whole by its IP, we can bind our local server environment to to ensure that it will be accessible only locally and through Tor.

On a system where we can call a Python module directly, we might choose to use the http.server module. After changing directories to one which contains content we would like to host, we can run a server directly from the command line.

Using Python 3 and http.server, we can use the following string to bind to and launch a server on port 8080.

python3 -m http.server --bind 8080

Either of these will serve as enough for a test server, but for any larger or more permanent project a full hosting stack will be more useful. Nginx provides a server backend which can be more suitably hardened and secured against the potential threats against a hidden service, although Apache or other HTTP server software can certainly work. Just be sure that it's bound to to prevent discovery through services such as Shodan.

If you have Fing network scanner, you can confirm this is working by running the following in a console.

fing -s -o text,console

You should see output like the image below if your server is running.

Just like that, a Fing scan shows us our server.

To ensure that our server is functional, we'll want to test our local address ( or "localhost" in a web browser by opening it as an address followed by a port number, as seen below.


In order to make testing the server easier, it may be useful to create an "index.html" file in the directory from which the server is being run. Something as simple as the file below will work.

Null Byte

The result will look like the following image, if it's working properly.

With our local server environment configured and available at, we can now start to link our server to the Tor network.

Step 4: Creating a Hidden Service

First, we will need to install or confirm that the Tor service/daemon is installed. The standalone Tor service is an active separate of the Tor Browser Bundle package, and for Linux/Unix is available here. On Ubuntu or Debian-based distros with apt package management, the following command should work assuming Tor is in the distro's repositories.

sudo apt-get install tor

To confirm the location of our Tor installation and configuration, we can use whereis.

whereis tor

This will show us a few of the directories which Tor uses for configuration. We're looking for our "torrc" file, which is most likely in /etc/tor.

We can move to that directory with cd, as we run the command below.

cd /etc/tor

Finally, confirm that "torrc" is present by simply running ls. If the torrc file is present, we will want to edit it. We can use Vim, emacs, or simply GNU nano to edit the file. To edit the file in nano, simply run the following in terminal.

nano torrc

The section we wish to edit follows this banner:

############### This section is just for location-hidden services ###

We can jump directly to this section by pressing Ctrl+W, typing location-hidden, and pressing Enter. In order to direct Tor to our hidden service, we'll want to un-comment two lines.

HiddenServiceDir /var/lib/tor/hidden_service/
HiddenServicePort 80

To do this, we simply remove the "#" symbols at the beginning of those two lines.

Next, we'll want to correct the port on which Tor looks for our server. If we're using port 8080, we'll want to correct the line from port 80 to port 8080. We will change the original seen below to the correct port number.

HiddenServicePort 80

We will change this to port 8080, as seen here:

HiddenServicePort 80

We can write our changes to the file with Ctrl+O and exit the editor with Ctrl+X.

Step 5: Testing the Tor Service

With the changes written to our torrc file and a server running at, making our server accessible over Tor is as simple as starting the Tor service. We can do this from the command line by typing the following.

sudo tor

Upon starting Tor for the first time with our new configuration, an .onion address will be generated automatically. This information will be stored in "/var/lib/tor/hidden_service" (or another directory if specified in the torrc file). We can move to this directory with cd, as seen below.

cd /var/lib/tor/hidden_service

After running ls to ensure that both the "hostname" and "private_key" files are in the directory, we can view our newly generated address by running cat in a terminal window as follows.

cat hostname

The string ending in .onion is our new hidden service address! While this one was automatically generated, we'll be able to customize it later to our preference.

We can test that our service is accessible by opening it in Tor Browser. If the address resolves to your server, you've successfully hosted a hidden service!

Step 6: Generating a Custom Onion Address

In order to customize our onion address, we'll need to generate a new private key to match a custom hostname. Due to the nature of Tor addresses being partially hashes, in order to create a custom address, we'll need to brute-force the address we want.

The more consecutive characters of a word or phrase we'd like to use, the longer it will take to generate. This time concern is somewhat of an exponential function, as the longer the sequence is, the generation time will become longer in folds, rather than in a linear way.

There are several tools available for this task, Eschalot and Scallion being some of the more popular options. Scallion uses GPU-cracking to generate addresses, while Eschalot works using wordlists. For this tutorial, we'll use Eschalot.

Begin by cloning the Eschalot git repository with the following commands in terminal.

git clone

Next, cd into the Eschalot directory as seen below.

cd /eschalot

Finally, run make to install Eschalot.


To generate a custom address, we can use a command like the one below.

./eschalot -vct4 -p null

In this command, 4 is the number of CPU cores we wish to use, and null is the prefix, or first characters, of the address we're looking for. The program will continue to generate addresses with this prefix and a variety of suffixes. We can stop the program at any time by pressing Ctrl+C.

Once the program has generated an address you like, we can use it for our hidden service.

Step 7: Adding the Onion Address to the Service

First, we should stop our Tor service from running. We can switch the window where sudo tor was run and press Ctrl+C.

After this, we'll want to replace our hidden service private key with the one generated by Eschalot. Move back to the /var/lib/tor/hidden_service/ directory using cd as seen below.

cd /var/lib/tor/hidden_service/

Within this directory, we'll want to remove the hostname file, as it's going to be replaced by the hostname generated by our custom private key. We can do this using the rm command in terminal as follows.

rm hostname

Next, copy the RSA Private Key generated by Eschalot, beginning with "-----BEGIN RSA PRIVATE KEY-----" and ending with "-----END RSA PRIVATE KEY-----." This key can replace our automatically generated private key. We can replace it directly using cat with the following command.

cat > private_key

After running this command, right-click and paste the key into the command line window, then press Ctrl+D to write changes to the file. To ensure that the file has the correct private key, we can use cat again to view the file as follows.

cat private_key

After updating the private key, we can start Tor again with sudo tor, and check that a new hostname file has been generated by running ls. If a hostname file is in the folder, we can check that it matches our desired address with the following command.

cat hostname

If the hostname matches our desired choice, we can check in Tor Browser to make sure that it resolves to our site.

If the new onion address leads to your site, you've successfully hosted a hidden service and configured a custom address!

Now That You Know Tor Hidden Services

This process can be replicated for almost any standard website or service, and the process executed on a VPS, virtual machine, or even a Raspberry Pi.

A proper Tor service should be hardened and supported by more than just Python's server module, but the possibilities when combined with Nginx or other server technologies are as vast as the internet itself, or perhaps even deeper.

Thanks for reading! If you have any questions, you can ask them here in the comments or on Twitter @tahkion.

Want to start making money as a white hat hacker? Jump-start your white-hat hacking career with our 2020 Premium Ethical Hacking Certification Training Bundle from the new Null Byte Shop and get over 60 hours of training from ethical hacking professionals.

Buy Now (96% off) >

Cover image and screenshots by TAKHION/Null Byte

Our Best Hacking & Security Guides

New Null Byte posts — delivered straight to your inbox.


Very nice tutorial thank you. If you can do some services for me with a fee just to create this and host a landing page, message me or mail to pivolga at protonmail dot ch

I used LightTPD as the server wonderfully.

Can we use the hidden service on any other port other than 8080???

Share Your Thoughts

  • Hot
  • Latest