Tor User Manual

Author: Runa A. Sandvik
Contact:, available in Arabic, English, Farsi, French, Mandarin, and Spanish
Version: 1.0

Table of Contents

1. Introduction
2. How Tor works
3. How to download Tor
4. How to use Tor
5. How to upgrade Tor
6. What to do when Tor does not connect
7. An introduction to Tor bridges
8. Frequently Asked Questions

1. Introduction

This manual contains information about how to download the Tor Browser Bundle and use it to browse the Internet, as well as information about what you can do if Tor is unable to connect to the network. If you can't find the answer to your question in this document, contact the Tor help desk at The help desk is run by a dedicated team of Tor Project members who will respond to your questions as quickly as possible.

2. How Tor works

Tor is a network of virtual tunnels that allows you to improve your privacy and security on the Internet. Tor works by sending your traffic through three random servers (also known as relays) in the Tor network, before the traffic is sent out onto the public Internet.

The image above illustrates browsing to different websites over Tor. The green monitors represent relays in the Tor network, while the three keys represent the layers of encryption between your computer and each relay.

Tor will anonymize the origin of your traffic, encrypt everything between your computer and the Tor network, and encrypt your traffic inside the Tor network. However, Tor will not encrypt your traffic between the Tor network and its final destination.

If you are communicating sensitive information, for example when logging on to a website with a username and password, make sure that you are using HTTPS (e.g., not

3. How to download Tor

The package we recommend to most users is the Tor Browser Bundle. However, if you are in a country where Tor is likely to be blocked, you may want to get the Pluggable Transports Tor Browser Bundle instead.

Both bundles contain a browser preconfigured for use with Tor and are easy to get started with: download one of the packages to your Desktop, extract the archive in the same place, and start Tor. The software will do the job of connecting you to the network and to the over 4000 relays around the world.

You can download the Tor Browser Bundle and the Pluggable Transports Tor Browser Bundle from our website by clicking on the links above. If you are unable to access our website, please contact the Tor help desk at for a list of website mirrors that you can use instead.

Our software is also available for Android-based phones, tablets, and computers from The Guardian Project in their F-Droid Repository and in the Google Play Store.

4. How to use Tor

After downloading and extracting the package onto your Desktop, you will be able to use Tor by running "Start Tor Browser" (or "start-tor-browser" on Linux). You will first see Vidalia, a control panel, start up and connect you to the network, followed by the Tor Browser confirming that you are now using Tor. This is done by displaying You can now browse the Internet through Tor.

NOTE: The Tor Browser Bundle will not provide anonymity to any other software or browsers that you have installed or will install on your computer. You need to use the browser that comes with Tor.

5. How to upgrade Tor

The page will let you know when a new version of Tor is available. To upgrade Tor, do the following:

  1. Download the new version to the same place you downloaded the old one (your Desktop is a good place)
  2. If you are already running Tor, make sure you close the browser and Vidalia
  3. Extract the new version and let it overwrite the old one
  4. Start Tor by running "Start Tor Browser" (or "start-tor-browser" on Linux)

6. What to do when Tor does not connect

In some cases, it will appear as if Vidalia is stuck when trying to connect to the network. If this happens, check the Vidalia message log for errors: open the Vidalia control panel, click on click on Message Log and select the Advanced tab. It may be that Tor won't connect because:

The system clock is off: Make sure that the date and time on your system is correct, for example by synchronizing the system clock with an Internet time server. Once that's done, restart Tor.

You are behind a restrictive firewall: To tell Tor to only try port 80 and port 443, open the Vidalia control panel, click on Settings and Network, and tick the box that says My firewall only lets me connect to certain ports.

Your anti-virus program is blocking Tor: Make sure that your anti-virus program is not preventing Tor from making network connections.

If Tor still doesn't work, it's likely that your Internet Service Provider (ISP) is blocking Tor. Very often this can be worked around with Tor bridges (see below for more information).

If you need help with figuring out why Vidalia is stuck, contact the Tor help desk at

7. An introduction to Tor bridges

Tor bridges are hidden relays which make Tor more difficult to block. To use a bridge, you will first have to locate one; you can visit, or you can send an email to If you decide to send an email, please make sure that you write get bridges in the body of the email. Without this, you will not get a reply.

Configuring more than one bridge address will make your Tor connection more stable, in case some of the bridges become unreachable. There is no guarantee that the bridge you are using now will work tomorrow, so you should make a habit of updating your list of bridges every so often.

Once you have a set of bridges to use, open the Vidalia control panel, click on Settings, Network and tick the box that says My ISP blocks connections to the Tor network. Enter the bridges in the box below, hit OK and start Tor again.

8. Frequently Asked Questions

This section will answer some of the most common questions. If your question is not mentioned here, please send an email to

8.2 Vidalia asks for a password

You should not have to enter a password when starting Vidalia. If you are prompted for one, you are likely affected by one of these problems:

Vidalia and Tor are already running: For example, this situation can happen if you installed the Vidalia bundle and now you're trying to run the Tor Browser Bundle. In that case, you will need to close the old Vidalia and Tor before you can run this one.

Vidalia crashed, but left Tor running: If the dialog that prompts you for a control password has a Reset button, you can click the button and Vidalia will restart Tor with a new random control password. If you do not see a Reset button, or if Vidalia is unable to restart Tor for you; go into your process or task manager, and terminate the Tor process. Then use Vidalia to restart Tor.

For more information, see the FAQ on the Tor Project website.

8.3 Flash does not work

For security reasons, Flash, Java, and other plugins are currently disabled for Tor. Plugins operate independently from Firefox and can perform activity on your computer that ruins your anonymity.

Most YouTube videos work with HTML5, and it is possible to view these videos over Tor.

8.4 I want to use the browser I normally use

For security reasons, we recommend that you only browse the web through Tor using the Tor Browser Bundle. It is technically possible to use Tor with other browsers, but by doing so you open yourself up to potential attacks.

8.5 Why Tor is slow

Tor can sometimes be a bit slower than your normal Internet connection. After all, your traffic is sent through many different countries, sometimes across oceans around the world!