How to setup a Tor relay or Tor bridge

18th June, 2009

For those in Iran. Here is a guide in Farsi for installing Tor so you can surf the web without censorship: http://greenoolo.pieceoftheworld.org/

IMPORTANT UPDATE (23/06/09): New email addresses have been added, and others updated. If you have Tor setup in bridge mode, resend your connection information to us.

IMPORTANT UPDATE #2: When posting in the comments section do not post your normal email address, do not use your name/alias (make up a new one) or post other personally identifiable information. This is very important.

UPDATE: slseveral sends this interesting read: http://blog.torproject.org/blog/measuring-tor-and-iran That might ease those wondering if we’re actually helping 🙂


What is Tor? (from https://www.torproject.org/)

“Tor protects you by bouncing your communications around a distributed network of relays run by volunteers all around the world: it prevents somebody watching your Internet connection from learning what sites you visit, and it prevents the sites you visit from learning your physical location. Tor works with many of your existing applications, including web browsers, instant messaging clients, remote login, and other applications based on the TCP protocol.”

This is something of great value to our friends in Iran.

Get Tor

https://www.torproject.org/easy-download.html.en

and install (detailed instructions Windows, Os X) (short version: double click install file)


Relay or Bridge?

A relay will be a proxy in the Tor network and help speed up the network for the people using it – a bridge, on the other hand, will enable people to reach the Tor network if the relays are blacklisted.

If you setup a bridge, you will need to get its address to the people that are going to use it (more on that later. Short: do not post it publicly, like in the comments below).

IMPORTANT: We’re going to need both sorts (mostly relays though), so please answer the poll (at the end) on which type you’ve set up. And if the type doesn’t matter to you, please check the poll to see how others have chosen and balance it up.


Relay:

(from https://www.torproject.org/docs/tor-doc-relay.html.en#setup)

  • Right click on the Vidalia icon in your task bar. Choose Control Panel.
  • Click Setup Relaying.
  • Choose Relay Traffic for the Tor network.
  • Enter a nickname for your relay. (Optional, enter contact information.)
  • Change ports from the default ports (needs to be >1024 on Os X and Linux/Unix)
  • If you have UPnP: Choose Attempt to automatically configure port forwarding. Push the Test button to see if it works. If it does work, great. If not, see “Firewall/router” below.
  • Choose the Bandwidth Limits tab. Select how much bandwidth you want to provide for Tor users like yourself.
  • Choose the Exit Policies tab. If you want to allow others to use your relay for these services, don’t change anything. Un-check the services you don’t want to allow through your relay. If you want to be a non-exit relay, un-check all services.
  • Click the Ok button. See “Check if it works” below for confirmation that the relay is working correctly.

Firewall/Router:

If you are using a firewall, open a hole in your firewall/router so incoming connections can reach the ports you configured (Relay Port (plus Directory Port if you enabled it)). Make sure you allow all outgoing connections, so your relay can reach the other Tor relays.

Check if it works:

Restart your relay. If it logs any warnings, address them. Look at the updates at the end of the post for help resolving issues that arise.

As soon as your relay manages to connect to the network, it will try to determine whether the ports you configured are reachable from the outside. This may take up to 20 minutes. Look for a log entry like Self-testing indicates your ORPort is reachable from the outside. Excellent. If you don’t see this message, it means that your relay is not reachable from the outside — you should re-check your firewalls, check that it’s testing the IP and port you think it should be testing, etc.

Problems?

And now what?

Well, congratulations, this is it. People can now surf the internet without fear of filtering/blocking or surveillance. Collect your karma points and continue following https://twitter.com/#search?q=%23IranElection or http://www.huffingtonpost.com/2009/06/13/iran-demonstrations-viole_n_215189.html


Bridge:

  • Right click on the Vidalia icon in your task bar. Choose Control Panel.
  • Click Setup Relaying.
  • Click Help censored users reach the Tor network
  • Enter a nickname for your relay. (Optional, enter contact information.)
  • Change ports from the default ports (needs to be >1024 on Os X and Linux/Unix)
  • If you have UPnP: Choose Attempt to automatically configure port forwarding. Push the Test button to see if it works. If it does work, great. If not, see “Firewall/router” below.
  • Choose the Bandwidth Limits tab. Select how much bandwidth you want to provide for Tor users like yourself.
  • Click the Ok button. See “Check if it works” below for confirmation that the bridge is working correctly.
  • Now scroll down to “Get the address to those that need it” and follow the instructions. Do NOT publish your connection information in the comments.

Firewall/Router:

If you are using a firewall, open a hole in your firewall/router so incoming connections can reach the ports you configured (Relay Port (plus Directory Port if you enabled it)). Make sure you allow all outgoing connections, so your relay can reach the other Tor relays.

Check if it works:

Restart your bridge. If it logs any warnings, address them. Look at the updates at the end of the post for help resolving issues that arise.

As soon as your bridge manages to connect to the network, it will try to determine whether the ports you configured are reachable from the outside. This may take up to 20 minutes. Look for a log entry like Self-testing indicates your ORPort is reachable from the outside. Excellent. If you don’t see this message, it means that your relay is not reachable from the outside — you should re-check your firewalls, check that it’s testing the IP and port you think it should be testing, etc.

Problems?

Get that address to those that need it (IMPORTANT)

After successfully setting up the bridge, click “Setup Relay” and you will see your IP port and a string of chars, this is your bridge address.

Your bridge address is not posted publicly, you need to get it to those that need it.

Email this bridge address to anonygreen@gmail.com, gr88proxies@googlegroups.com, tor@austinheap.com, irancurtain@iansbrain.com and protesterhelp@gmail.com or Direct Message (private message) in Twitter to @iran09, @austinheap, @protesterhelp, @persiankiwi or @stopahmadi. If you email be sure to include “Tor bridge” in the subject line.


And now what?

Well, congratulations, this is it. People can now surf the internet without fear of filtering/blocking or surveillance. Collect your karma points and continue following https://twitter.com/#search?q=%23IranElection or http://www.huffingtonpost.com/2009/06/13/iran-demonstrations-viole_n_215189.html


Poll:


Update 1:
GeoIP error:

Ian Says:

19th June, 2009 at 02:38 |

download this http://git.torproject.org/checkout/tor/master/src/config/geoip and put it in C:\Documents and Settings\{username}\Application Data\Tor\

Open ports in the router:

Carl Says:

21st June, 2009 at 13:01 |

Then you need to forward that port from your router to your computer.

See: http://portforward.com/ for info and howto:s

Update2:
DNS hijacking
:

From David and slseveral:

http://dnsresolvers.com/ got me past the hijacking errors (Verizon FIOS DNS servers.)

Update3:
DIR Port not reachable, but OR port is.

Boogs says:
“THE SOLUTION, at least for me, was to download the latest unstable version at http://www.torproject.org/download.html.en and presto, now everything works just like it should. There must be a bug in the latest stable version.”


How can you help, 2nd edition.

Talk to friends and spread the word of the Iranian struggle for freedom. Refer them to this guide if you think it was good.

If you know Farsi, please help translate

https://www.torproject.org/docs/tor-doc-windows.html.en

https://www.torproject.org/docs/tor-doc-osx.html.en

Advertisements

221 Responses to “How to setup a Tor relay or Tor bridge”

  1. […] This post was Twitted by calimbasina […]

  2. Dear Ladies and Gentlemen
    Dear Friends

    I am writing you from Iran.
    Thanks for giving me the possibility to answer you in this particular sensitive case!

    At first I would recommend you to establish a secure connection like https:// … Secure Mail and connection, because this letter – sent by “simple” http:// … – could be hacked and opened by anyone and any government that you can imagine.

    Secondly, we are not able – at the present time and since several weeks – to click and get to any Website concerning Tor, TorProject and Tor Bridges et cetera!

    It would be useful to send us directly (to our e-mails) the new, most recent and almost “unknown” Tor Bridges in order to set Tor in motion, activate Tor Anonymizer and its Vidalia-Bundle programme.

    I’ve been using the well-tried and stable Tor/Vidalia-Bundle connection since four years without any problem until the last weeks, as Tor and Google established a special site for Tor in connection with filtering in Iran. The iranian government then acquired knowledge about Tor and its potential and abilities.

    Now iranian government blocked Tor Websites. Tor Bridges are unreachable for us, unless we get them via https:// … on e.g. Gmail or Yahoo Mail.

    I would appreciate it, if you could send us Tor Bridges containing IP No./Port/Fingerprint as following:

    65.38.17.23:443 444c7f993fc52fe31c139ea98b4526cd425574db

    91.143.81.140:443 aac8e94cfeac563dc56fbe52b544d363f5f87e2d

    78.51.24.120:443 4f7ca9413130d60e1bf488613eebdff54decf490

    Thanks for your efforts in advance.

    Kind Regards
    Emiliano ZAPATA

    • Hawk said

      xxx.xxx.xxx.xxx:xxxx (edit: mod)

      • Carl said

        Do not post your bridge address here. Please read the instructions one more time.

        The distribution of bridge addresses is being handled through trusted sources. Do not give bridges to just anyone who asks for them. Any bridge posted publicly is potentially compromised.

  3. MichaellaS said

    tks for the effort you put in here I appreciate it!

  4. LnddMiles said

    The best information i have found exactly here. Keep going Thank you

  5. Carl said

    Many thanks

  6. flashy said

    Thanks this was a good read

  7. lin said

    I cannot connect to the tor ,it doesn’t work,please give me a bridge, many thanks.
    xl3353@126.com

  8. yay said

    81.167.139.78:443 45031E3F99C0B504E0BFC4EAFD00A8846CE65210

  9. Tim Wood said

    Typically I do not make comments on blogs, but I have to mention that this post really forced me to do so. Really admirable post

  10. james said

    tor is not connecting in nigeria, pls help me out!!!i need to browse

  11. Pls i need tor bridges to browse my internet

  12. junaid said

    pls i need new bridge to get connected….pls

  13. Anks said

    Please here we all am being blocked by Cyberoam.. bridges requested via mail aren’t working ..please send us a few bridges…

  14. Bala said

    How can we get a tor bridges in Nigeria/west African

  15. i find very difficult to browzes with my tor pls. send me a new bridges to access my tor browzer.

  16. pls. help me my tor browzer is not working,pls. help with new bridges thanks.

  17. yinka66@yahoo.com said

    pls send me new bridge to browse in nigeria.

  18. Russ said

    I’m having problems relaying – It use to work before until I reinstalled my system – MY OS is Win 7 – I’m using ESET with the firewall – I allowed complete access for Tor – but still no success – I have a Linksys wireless router WRT610N ver1 with firmware updated – I’ve enable Upnp – – Tor is working but I’m not able to relay – ?

  19. Russ said

    Follow up – I just figured out the problem – Opened up firewall to Fire Fox both ways – this has been the problem for some time now and just thought that since Fire Fox uses the Tor button there might be a link to the problem and – I was correct – by luck

  20. […] How to setup a Tor relay or Tor bridge by AnonyGreen […]

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: