onion-dao / tornode

🧅 OnionDAO Tornode

This is an initiative by the OnionDAO.

To qualify for your POAP you need to:

1. Set up an exit node (see setup script below)
2. Keep your node running for at least one month
3. Claim your POAP at poap.delivery

---

Setup TL;DR

Are you in a rush?

1. Buy a VPS with 1.5GB ram (crowdsourced list of suitable providers here)
2. Run curl https://raw.githubusercontent.com/Onion-DAO/tornode/main/setup.sh --output oniondao.setup.sh && sudo bash oniondao.setup.sh $HOME && rm oniondao.setup.sh
3. Follow on-screen instructions

---

Text instructions

You should run your Tor exit node in a data center, probably as a VPS. The requires specs are:

1. Any modern CPU
2. 1.5 GB RAM
3. 256MB disk space available for Tor

For details see the official documentation.

Setup steps

In order to qualify for an Onion POAP, you need to run a Tor exit node. Ideally, you do so at a datacenter. We're going to assume you are using a VPS (virtual private server) with Ubuntu 20.04 LTS.

Step 1: purchase a VPS

Not all VPS providers like it if you run a Tor exit node.

• OnionDAO keeps a crowdsourced list of suitable providers here
• The Tor community keeps a list of exit node friendly providers here
• A crypto community member hosts a list of those accepting Bitcoin here

Most VPS providers have different VPS options. Choose one that has at least 1.5GB RAM. When asked about an operating system, choose Ubuntu 20.04 LTS.

Your provider should send you a username, password and ip address. Ssh into your server now.

Step 2: run the install script

Clone this repo and run the setup script:

git clone https://github.com/Onion-DAO/tornode.git
cd tornode
sudo bash setup.sh

Step 3: keep it running for a month

After a month, the POAPs will de distributed through poap.delivery.

---

Video instructions

Do you prefer a video walkthrough? You can view a recording of our setup livestream here in the Rocketeer Discord.

tornode's Issues

Tor fails to update or install

I'm running ubuntu 20.04 and tried using the oniondao update option on my server when it failed to install from the Tor repo due to a signing error.

I was able to manually install the latest Tor package from the repo, but the URL may have changed. I manually installed my package from https://deb.torproject.org/torproject.org/pool/main/t/tor/ and was able to register it using oniondao register

.

[notice] Unable to find IPv6 address for ORPort

In /var/log/tor/notices.log
'[notice] Unable to find IPv6 /address for ORPort 9001. You might want to specify IPv4Only to it or set an explicit address or set Address.'

Change config to 'ORPort 9001 IPv4Only' if IPv6 not being used.

client_loop: send disconnect: Broken pipe

This is the error I got when I am trying to complete the installation. Should I reinstall again

Cannot join Oracle due to port 80 connection failing

I'm trying to join my Tor nodes to the network. However, I cannot, because the port scan error fails. It assumes that my directory port is 80; however, some of my nodes run other services, so the directory is on the default port of 9030. How can I update this?

Error:

🛑 OnionDAO Oracle error: Port scan error: Error connecting to [MY IP ADDRESS] on port 80

torrc configuration includes:

DirPort 9030