How to run the Particl wallet as a Tor Hidden Service

Tor hidden service conceals your IP address and thus your privacy. It also protects your machine from geolocation and its possible ugly consequences, and automatically sets you up for both incoming and outgoing connections, helping the Particl network.

It is recommended to always run the Particl build releases through Tor.

We highly suggest that you download the particl wallet and verify the checksums!

Beginner Hint – only copy text/command after “$”

At a command prompt just enter “tor”.

 $ tor

If it is already running, you should get an error message that says something like “Is tor already running?” That's good if you do. If not, at the command prompt install with:

 $ sudo apt-get install tor
$ sudo nano /etc/tor/torrc

We need to add our config to the Tor configuration file which will signal Tor to create a hidden service.

 HiddenServiceDir /var/lib/tor/particl-service/
 HiddenServicePort 51738

Save the file with “CTRL-X”, type “y” to overwrite and the text editor will exit.

$ sudo service tor restart

At a command prompt enter

$ sudo cat /var/lib/tor/particl-service/hostname

It should return an .onion address, which we'll refer to as [yourexternalip].onion

It is recommended to always run the Particl build releases through Tor.

In the .particl directory there will be a particl.conf file. The wallet can run without that but you can include a lot of startup and operating instructions with it.

$ nano ~/.particl/particl.conf

*Beginner Hints
~ is your home directory (the folder which has your Documents & Downloads folders.

A '.' in front of a foldername means it's hidden, when browsing the folders through an interface, press CTRL+H to make hidden folders visible.*

If nano returns the following error:

Error writing ~/.particl/particl.conf: No such file or directory

Then you'll have the make the directory yourself (because the Particl wallet hasn't ever ran on the system yet)!

$ mkdir ~/.particl
$ nano ~/.particl/particl.conf

Your particl.conf file will need to contain at least the following. Replace [yourexternalip].onion with the onion domain you got from step 3!


Now you're ready to go, start it up. You should start making connections. If you use the getpeerinfo command you'll see the addresses of the peers and they should all be .onion addresses. Some of the peers will show your external IP .onion address and that's normal, those are incoming connections.

← back to Tutorials

Author: AM | Updated: August 18, 2017