wiki:org/teams/CommunityTeam/Support

Table of Contents

  1. Resources
  2. QA
    1. Most Frequently Asked Questions
      1. Something is wrong with Tor Browser and it won't connect
      2. Why is the first IP address in my relay circuit always the same?
      3. Why is Tor Browser built from Firefox and not some other browser?
      4. Can I use Flash player in Tor Browser?
      5. My antivirus or malware protection is blocking me from accessing Tor …
      6. Can I use Tor with some other web browser?
      7. When I use Tor Browser, will anyone be able to tell which websites I visit?
      8. Can I run Tor on an iOS device?
    2. Tor Browser
      1. Most Common Issues in the Latest Tor Browser Stable
      2. Why is the first IP address in my relay circuit always the same?
      3. When I use Tor Browser, will anyone be able to tell which websites I visit?
      4. Why is Tor Browser built from Firefox and not some other browser?
      5. My favorite website is blocking access over Tor!
      6. Our website is blocked by a censor. Can Tor Browser help users access …
      7. Can I use Tor with some other web browser?
      8. My antivirus or malware protection is blocking me from accessing Tor …
      9. I downloaded and installed Tor Browser for Windows, but now I can't find it
      10. Can I use Flash player in Tor Browser?
      11. Does using Tor Browser protect other applications on my computer?
      12. Should I install a new add-on or extension in Tor Browser, like …
      13. Can I pick which country I'm exiting from?
      14. Is there support for *BSD?
      15. Where can I get bridges?
      16. Something is wrong with Tor Browser and it won't connect
      17. How do I view Tor Browser message log?
      18. Is Tor Browser slower than other browsers?
      19. Is it safe to run Tor Browser and another browser at the same time?
      20. Can I download Tor Browser for ChromeOS?
      21. I'm having a problem with DuckDuckGo.
      22. I'm having a problem with NoScript
      23. I'm having a problem with HTTPSEverywhere
      24. How do I update Tor Browser?
      25. How do I uninstall Tor Browser?
      26. Is there a way to change the IP address that Tor Browser assigns me …
      27. A website (bank, email provider, etc..) locks me out whenever I use …
      28. Which platforms is Tor Browser available for?
      29. Can I set Tor Browser as my default browser?
      30. Does running Tor Browser make me a relay?
      31. Why does Tor Browser ship with Javascript enabled?
      32. Can you get rid of all the captchas?
      33. Can I run multiple instances of Tor Browser?
      34. I need Tor Browser in a language that's not English
      35. Will my network admin be able to tell I'm using Tor Browser?
      36. Does Tor Browser use a different circuit for each website?
      37. Why did my search engine switch to DuckDuckGo?
      38. Why does my Tor Browser say something about Firefox not working?
    3. Tor Messenger
      1. Does Tor Project make an application for private chat?
      2. What platforms is Tor Messenger available on?
      3. Where can I download Tor Messenger?
    4. Mobile
      1. Can I run Tor on an Android device?
      2. Who is the Guardian Project?
      3. Can I run Tor on an iOS device?
      4. How do I run Tor on Windows Phone?
    5. GetTor
      1. How do I download Tor if the torproject.org is blocked?
        1. To use GetTor via email
        2. To use GetTor via Twitter
        3. To use GetTor via XMPP (Tor Messenger, Jitsi, CoyIM)
    6. Connection issues
    7. Censorship
    8. HTTPS
      1. When I'm using Tor, can eavesdroppers still see the information I …
    9. Operator
      1. How do I run a middle or guard relay on Debian?
      2. How do I run an exit relay on Debian?
      3. How do I run a middle or guard relay on FreeBSD or HardenedBSD?
      4. How do I make sure that I'm using the correct packages on Ubuntu?
      5. What is a bridge?
      6. How do I run a obfs4 bridge on Debian?
      7. Should I run an exit relay from home?
    10. Onions
      1. I've heard about websites that are only accessible over Tor. What are …
      2. What is a .onion?
      3. I cannot reach X.onion!
    11. Misc
      1. I have a compelling reason to trace a Tor user. Can you help?
      2. I'm receiving the error "could not connect to control port Tor"
      3. Can I use Tor with bittorrent?
      4. The files on my computer have been locked, and someone is demanding I …
      5. Does Tor keep logs?
      6. Does Tor Project offer email service or other privacy protecting web …
      7. Can I use the Tor logo in my product?
      8. I'm having a problem updating or using Vidalia
      9. Does the Tor Project offer hosting?
      10. Can I change the number of hops Tor uses?
      11. How can I share files anonymously through Tor?
  3. Contact
      1. How do I volunteer with Tor Project?
      2. How do I reach the Tor Project press person?
      3. How do I report a bug or some other issue?
      4. Can I use a VPN with Tor?

Support Portal

Resources

Tor Browser Manual with step-by-step instructions on downloading and using Tor Browser. If you're a brand new Tor Browser user, start here!

Glossary of terms about and related to Tor

QA

Most Frequently Asked Questions

Something is wrong with Tor Browser and it won't connect

One of the most common issues that causes connection errors in Tor Browser is an incorrect system clock. Please make sure your system clock and timezone are set accurately. If this doesn't fix the problem, see the ​Troubleshooting page on the ​Tor Browser User Manual https://tb-manual.torproject.org/en-US/troubleshooting.html

Why is the first IP address in my relay circuit always the same?

That is normal Tor behavior! The first relay in your circuit is called an "entry guard" or "guard". It is a fast and stable relay that remains the first one in your circuit for 2-3 months in order to protect against a known anonymity-breaking attack. The rest of your circuit changes with every new website you visit, and all together these relays provide the full privacy protections of Tor. For more information on how guard relays work, see https://blog.torproject.org/blog/improving-tors-anonymity-changing-guard-parameters and http://www-users.cs.umn.edu/~hopper/single_guard.pdf

Why is Tor Browser built from Firefox and not some other browser?

Tor Browser is a modified version of Firefox specifically designed for use with Tor. A lot of work has been put into making the Tor Browser, including the use of extra patches to enhance privacy and security. Unfortunately, no other browser today is suitable for the modifications required for these privacy properties. While it is technically possible to use Tor with other browsers, you may open yourself up to potential attacks or information leakage, so we strongly discourage it. For more information on the design of Tor Browser, see https://www.torproject.org/projects/torbrowser/design/

Can I use Flash player in Tor Browser?

You might have noticed that Flash is disabled in Tor Browser. We recommend that you not enable Flash. In fact, Flash isn't safe to use in any browser — it's a very insecure piece of software that can easily compromise your privacy or serve you malware. Fortunately, most websites, devices, and other browsers are moving away from the use of Flash.

My antivirus or malware protection is blocking me from accessing Tor Browser.

Most antivirus or malware protection allows the user to "whitelist" certain processes that would otherwise be blocked. Please open your antivirus or malware protection software and look in the settings for a "whitelist" or something similar, and then exclude the following processes: For Windows:

firefox.exe

tor.exe

obfs4proxy.exe (if you use bridges)

For OS X

TorBrowser

tor.real

obfs4proxy (if you use bridges)

Then restart Tor Browser

Can I use Tor with some other web browser?

We strongly recommend against using Tor in any browser other than Tor Browser. Using Tor in another browser can leave you pretty vulnerable; you don't get nearly the same privacy protections that you get when using Tor Browser.

When I use Tor Browser, will anyone be able to tell which websites I visit?

Tor Browser prevents people from knowing the websites you visit. Some entities, such as your Internet Service Provider, may be able to see that you're using Tor.

Can I run Tor on an iOS device?

There is currently no official version of Tor Browser for iOS. There is an iOS app called Onion Browser, which is open source, uses Tor routing, and is developed by someone who works closely with the Tor Project. However, Apple requires browsers on iOS to use something called Webkit, which prevents Onion Browser from having the same privacy protections as Tor Browser. For more information about Onion Browser and its limitations, see https://blog.torproject.org/blog/tor-heart-onion-browser-and-more-ios-tor

Tor Browser

Most Common Issues in the Latest Tor Browser Stable

Whenever we release a new stable version of Tor Browser, we write a blog post that details its new features and known issues. If you started having issues with your Tor Browser after an update, check out https://blog.torproject.org for the most recent stable Tor Browser post to see if your issue is listed.

Why is the first IP address in my relay circuit always the same?

Please see the answer from our Most Frequently Asked Questions list.

When I use Tor Browser, will anyone be able to tell which websites I visit?

Please see the answer from our Most Frequently Asked Questions list.

Why is Tor Browser built from Firefox and not some other browser?

Please see the answer from our Most Frequently Asked Questions list.

My favorite website is blocking access over Tor!

Sorry to hear that you can't visit the website you wanted! Sometimes websites will block Tor users because they can't tell the difference between the average Tor user and some malicious or automated traffic. The best success we've had in getting sites to unblock Tor users is getting users to contact the site administrators directly. Something like this might do the trick:

"Hi! I tried to access your site xyz.com while using Tor Browser and discovered that you don't allow Tor users to access your site. I urge you to reconsider this decision; Tor is used by people all over the world to protect their privacy and fight censorship. By blocking Tor users, you are likely blocking people in repressive countries who want to use a free internet, journalists and researchers who want to protect themselves from discovery, whistleblowers, activists, and ordinary people who want to opt out of invasive third party tracking. Please take a strong stance in favor of digital privacy and internet freedom, and allow Tor users access to xyz.com. Thank you."

In the case of banks, and other "sensitive" websites, it is also common to see geography-based blocking (if a bank knows you generally access their services from one country, and suddenly you are connecting from an exit relay on the other side of the world, your account may be locked or suspended).

If you are unable to connect to an onion service, please see [#IcannotreachX.onion I cannot reach X.onion!

Our website is blocked by a censor. Can Tor Browser help users access our website?

Tor Browser can certainly help people access your website in places where it is blocked. Most of the time, simply downloading the Tor Browser and then using it to navigate to the blocked site will allow access. In places where there is heavy censorship we have a number of censorship circumvention options available, including pluggable transports. For more information, please see the Tor Browser User Manual section on censorship

Can I use Tor with some other web browser?

Please see the answer from our Most Frequently Asked Questions list.

My antivirus or malware protection is blocking me from accessing Tor Browser.

Please see the answer from our Most Frequently Asked Questions list.

I downloaded and installed Tor Browser for Windows, but now I can't find it

The file you download and run prompts you for a destination. If you don't remember what this destination was, it's most likely your Downloads or Desktop folder. The default setting in the Windows installer also creates a shortcut for you on your Desktop, though be aware that you may have accidentally unticked the option to create a shortcut. If you can't find it in either of those folders, download it again and look for the prompt that asks you to choose a directory to download it in. Choose a directory location that you'll remember easily, and once the download finishes you should see a Tor Browser folder there.

Can I use Flash player in Tor Browser?

Please see the answer from our Most Frequently Asked Questions list.

Does using Tor Browser protect other applications on my computer?

Only Tor Browser's traffic will be routed over the Tor network. Any other application on your system (including other browsers) will not have their connections routed over the Tor network, and will not be protected. They need to get configured separately to use Tor.

If you need to be sure that all traffic will go through the Tor network, you might want to look at the Tails live system.

Should I install a new add-on or extension in Tor Browser, like AdBlock Plus or uBlock Origin?

It's strongly discouraged to install new add-ons in Tor Browser, because they can compromise both your privacy and your security. Plus, Tor Browser already comes installed with two add-ons — HTTPS Everywhere and NoScript — which give you a lot of added protection.

Can I pick which country I'm exiting from?

Modifying the way that Tor creates its circuits is strongly discouraged. You get the best security that Tor can provide when you leave the route selection to Tor; overriding the entry / exit nodes can compromise your anonymity. If the outcome you want is simply to be able to access resources that are only available in one country, you may want to consider using a VPN instead of using Tor. Please note that VPNs do not have the same privacy properties as Tor, but they will help solve some geolocation restriction issues.

Is there support for *BSD?

Sorry, but there is currently no official support for running Tor Browser on *BSD. There is something called the TorBSD project, but their Tor Browser is out of date and cannot be used safely.

Where can I get bridges?

Some bridges are built in to Tor Browser, and you can use those bridges by choosing "configure" (then following the prompts) in the Tor Launcher window that pops up when you open Tor Browser for the first time. If you need other bridges, you can get them at our Bridges website. For more information about bridges, see the Tor Browser manual.

Something is wrong with Tor Browser and it won't connect

Please see the answer from our Most Frequently Asked Questions list.

How do I view Tor Browser message log?

Click the button labelled “Copy Tor Log To Clipboard” that appears in the dialog window when Tor Browser is first connecting to the network.

or

If Tor Browser is already open, click on the Torbutton icon (the small green onion at the top-left of the screen), then “Open Network Settings”, then “Copy Tor Log To Clipboard”

Is Tor Browser slower than other browsers?

Using Tor Browser can sometimes be slower than other browsers. The Tor network has over a million daily users, and just over 6000 relays to route all of their traffic, and the load on each server can sometimes cause a bit of latency. You can help improve the speed of the network by running your own relay, or encouraging others to do so. That said, Tor is much faster than it used to be and you may not actually notice any change in speed from other browsers.

Is it safe to run Tor Browser and another browser at the same time?

If you run Tor Browser and another browser at the same time, it won't have any affect on Tor's performance or privacy properties. However, be aware that your other browser is not keeping your activity private, and you may forget and accidentally use that nonprivate browser to do something that you intended to do in Tor Browser.

Can I download Tor Browser for ChromeOS?

Unfortunately, we don't have a version of Tor Browser that works for ChromeOS yet.

I'm having a problem with DuckDuckGo.

Please see the DuckDuckGo support portal. If you believe this is a Tor Browser issue, please report it on our bug tracker.

I'm having a problem with NoScript

Please see the NoScript FAQ. If you believe this is a Tor Browser issue, please report it on our bug tracker.

I'm having a problem with HTTPSEverywhere

Please see the HTTPS-Everywhere FAQ. If you believe this is a Tor Browser issue, please report it on our bug tracker.

How do I update Tor Browser?

Tor Browser will prompt you to update the software once a new version has been released: the Torbutton icon (the little green onion in the top left corner of the browser) will display a yellow triangle, and you may see a written update indicator when Tor Browser opens.

https://tb-manual.torproject.org/en-US/media/updating/update1.png https://tb-manual.torproject.org/en-US/media/updating/update3.png https://tb-manual.torproject.org/en-US/media/updating/update4.png

How do I uninstall Tor Browser?

Removing Tor Browser from your system is simple:

  1. Locate your Tor Browser folder or application. The default location on Windows is the Desktop; on macOS it is the Applications folder (on macOS, you have to move it into the Applications folder when you complete the installation process). On Linux, there is no default location, however the folder will be named "tor-browser_en-US" if you are running the English Tor Browser.
  2. Delete the Tor Browser folder or application.
  3. Empty your Trash

Note that your operating system’s standard “Uninstall” utility is not used.

Is there a way to change the IP address that Tor Browser assigns me for a particular site?

Tor Browser has two ways to change your relay circuit — “New Identity” and “New Tor Circuit for this Site". Both options are located in the Torbutton (little green onion) menu.

  • New Identity

This option is useful if you want to prevent your subsequent browser activity from being linkable to what you were doing before. Selecting it will close all your tabs and windows, clear all private information such as cookies and browsing history, and use new Tor circuits for all connections. Tor Browser will warn you that all activity and downloads will be stopped, so take this into account before clicking “New Identity”.

  • New Tor Circuit for this Site

This option is useful if the exit relay you are using is unable to connect to the website you require, or is not loading it properly. Selecting it will cause the currently-active tab or window to be reloaded over a new Tor circuit. Other open tabs and windows from the same website will use the new circuit as well once they are reloaded. This option does not clear any private information or unlink your activity, nor does it affect your current connections to other websites.

https://tb-manual.torproject.org/en-US/media/managing-identities/circuit_full.png

A website (bank, email provider, etc..) locks me out whenever I use Tor, what can I do?

Tor Browser often makes your connection appear as though it is coming from an entirely different part of the world. Some websites, such as banks or email providers, might interpret this as a sign that your account has been compromised, and lock you out. The only way to resolve this is by following the site’s recommended procedure for account recovery, or contacting the operators and explaining the situation. You may be able to avoid this scenario if your provider offers 2-factor authentication, which is a much better security option than IP-based reputations. Contact your provider and ask them if they provide 2FA.

Which platforms is Tor Browser available for?

Tor Browser is currently available on Windows, Linux and OSX. For Android, The Guardian Project maintains the Tor-powered apps Orbot and Orfox. Unfortunately, there is no official version of Tor for iOS yet.

Can I set Tor Browser as my default browser?

There is currently no supported method for setting Tor Browser as your default browser. The Tor Browser works hard to isolate itself from the rest of your system, and the steps for making it the default browser are unreliable. This means sometimes a website would load in the Tor Browser, and sometimes it would load in another browser, this type of behavior can be dangerous and anonymity-breaking.

Does running Tor Browser make me a relay?

Running Tor Browser does not make you act as a relay in the network. This means that your computer will not be used to route traffic for others. If you'd like to become a relay, please see our operator documents.

Why does Tor Browser ship with Javascript enabled?

We configure NoScript to allow JavaScript by default in Tor Browser because many websites will not work with JavaScript disabled. Most users would give up on Tor entirely if we disabled Javascript by default because it would cause so many problems for them.

Ultimately, we want to make Tor Browser as secure as possible while also making it usable for the majority of people, so for now, that means leaving Javascript enabled by default. For users who want to have Javascript disabled on all HTTP sites by default, we recommend changing your Tor Browser's security slider (in the Tor Browser Onion menu under "Security Settings"). The low/default setting allows Javascript, but the medium and high levels both block Javascript on HTTP sites.

Can you get rid of all the captchas?

Unfortunately, some websites deliver CAPTCHAS to Tor users, and we are not able to remove CAPTCHAs from websites. The best thing to do in these cases is to contact the website owners, and inform them that their CAPTCHAs are preventing users such as yourself from using their services.

Can I run multiple instances of Tor Browser?

We do not recommend running multiple instances of Tor Browser, and may not work as anticipated on many platforms.

I need Tor Browser in a language that's not English

We currently offer Tor Browser in the following languages:

  • English (en-US)
  • "العربية" (ar)
  • Deutsch (de)
  • Español (es-ES)
  • فارسى (fa)
  • Français (fr)
  • Italiano (it)
  • 日本語 (ja)
  • Korean (ko)
  • Nederlands (nl)
  • Polish (pl)
  • Português (pt-BR)
  • Русский (ru)
  • Türkçe (tr)
  • Vietnamese (vi)
  • 简体字 (zh-CN)

Will my network admin be able to tell I'm using Tor Browser?

When using Tor / Tor Browser, we do not make the guarantee that no one will be able to determine you are using Tor. Rather, the goal is that no one will know what you are using Tor for. Using pluggable transports can make identifying Tor traffic more difficult, but not impossible.

Does Tor Browser use a different circuit for each website?

In Tor Browser, every domain gets its own circuit. The Design and Implementation of Tor Browser document has further details regarding this issue.

Why did my search engine switch to DuckDuckGo?

With the release of Tor Browser 6.0.6, we switched to DuckDuckGo as the primary search engine. For a while now, Disconnect has had no access to Google search results which we used in Tor Browser. Disconnect being more of a meta search engine which allows users to choose between different search providers fell back to delivering Bing search results which were basically unacceptable quality-wise.

Why does my Tor Browser say something about Firefox not working?

Tor Browser is built using Firefox ESR, so errors regarding Firefox may occur. Please be sure no other instance of Tor Browser is already running, and that you have extracted Tor Browser in a location that your user has the correct permissions for. If you are running an anti-virus, please see [My antivirus/malware protection is blocking me from accessing Tor Browser], it is common for anti-virus / anti-malware software to cause this type of issue.

Tor Messenger

Does Tor Project make an application for private chat?

Yes! Tor Messenger, though still in beta, is a cross-platform chat program that aims to be secure by default and sends all of its traffic over Tor. It supports a wide variety of transport networks, including XMPP, IRC, Twitter, and others; enables Off-the-Record (OTR) Messaging automatically; has an easy-to-use graphical user interface; and a secure automatic updater.

See the introductory blog post for more information.

What platforms is Tor Messenger available on?

Tor Messenger (beta) is currently available on Linux, Windows and OSX.

Where can I download Tor Messenger?

While the Tor Messenger remains in beta, the latest downloads can be found on our wiki.

Mobile

Can I run Tor on an Android device?

Tor on Android is provided by The Guardian Project. More information can be found on the Orbot and Orfox web pages.

Who is the Guardian Project?

The Guardian Project maintains Tor (and other privacy applications) on Android. More info can be found on the Guardian Project's webiste.

Can I run Tor on an iOS device?

Please see the answer from our Most Frequently Asked Questions list.

How do I run Tor on Windows Phone?

Sorry, there is currently no supported method for running Tor on Windows Phone.

GetTor

How do I download Tor if the torproject.org is blocked?

If you can't download Tor through our website, you can get a copy of Tor delivered to you via GetTor. GetTor is a service that automatically responds to messages with links to the latest version of Tor Browser, hosted at a variety of locations that are less likely to be censored, such as Dropbox, Google Drive and Github.

To use GetTor via email

Send an email to gettor@…, and in the body of the message simply write “windows”, “osx”, or “linux”, (without quotation marks) depending on your operating system. GetTor will respond with an email containing links from which you can download Tor Browser package, the cryptographic signature (needed for verifying the download) [link to glossary definition of cryptographic signature; instructions for verification], the fingerprint of the key used to make the signature, and the package’s checksum. You may be offered a choice of “32-bit” or “64-bit” software: this depends on the model of the computer you are using; consult documentation about your computer to find out more.

To use GetTor via Twitter

To get links for downloading Tor Browser, send a direct message to @get_tor with one of the following codes in it (you don't need to follow the account).

Linux
OSX
Windows
To use GetTor via XMPP (Tor Messenger, Jitsi, CoyIM)

To get links for downloading Tor Browser, send a message to gettor@… with one of the following codes in it.

Linux
OSX
Windows

Connection issues

Censorship

HTTPS

When I'm using Tor, can eavesdroppers still see the information I share with websites, like login information and things I type into forms?

Tor protects eavesdroppers from learning sites that you visit. However, information sent unencrypted over the Internet using plain HTTP can still be intercepted by exit relay operators or anyone observing the traffic between your exit relay and your destination website. If the site you are visiting uses HTTPS, then the traffic leaving your exit relay will be encrypted, and won't be visible to eavesdroppers. If you are using HTTPS, your website URL will begin with "https://".

https://tb-manual.torproject.org/en-US/media/secure-connections/https.png

The following visualization shows what information is visible to eavesdroppers with and without Tor Browser and HTTPS encryption:

https://tb-manual.torproject.org/en-US/svg2.svg

Operator

How do I run a middle or guard relay on Debian?

  1. Run "apt-get install tor" (as root).
  2. Make sure your clock, date, and timezone are set correctly. Install the ntp or openntpd (or similar) package to keep it that way.
  3. Edit /etc/tor/torrc to look like the following:
    ## The IP address or hostname for incoming connections (leave commented and Tor will guess)
    #Address noname.example.com
    
    ## Set the nickname of this relay
    Nickname ididnteditheconfig
    
    ## Set your own contact info
    ContactInfo 0xFFFFFFFF Random Person <nobody AT example dot com>
    
    ## If you control multiple relays, include then in the family
    #MyFamily $keyid,$keyid,...
    
    ORPort 9001
    DirPort 9030
    
    ## Set your bandwidth rate (leave commented and Tor will run without bandwidth caps)
    #RelayBandwidthRate 30 MBytes
    #RelayBandwidthBurst 100 MBytes
    
    ExitPolicy reject *:*
    
  4. Run "service tor reload" (as root)
  5. After your relay connects to the network, it will try to determine whether the ports you configured are reachable from the outside. This step is usually fast, but it may take a few minutes. Look for a log entry in /var/log/syslog such as "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 the IP and ports you specified in your torrc are correct, etc.

When it confirms that it's reachable, it will upload a "server descriptor" to the directory authorities to let clients know what address, ports, keys, etc your relay is using. After a few hours (to give it enough time to propagate), you can query Atlas to see whether your relay has successfully registered in the network. If it hasn't, re-check firewalls, IP and ports again.

How do I run an exit relay on Debian?

  1. Review our Exit relay guidelines
  2. Run "apt-get install tor" (as root).
  3. Make sure your clock, date, and timezone are set correctly. Install the ntp or openntpd (or similar) package to keep it that way.
  4. Edit /etc/tor/torrc to look like the following:
## Set the nickname of this relay
Nickname ididnteditheconfig

## Set your own contact info
ContactInfo 0xFFFFFFFF Random Person <nobody AT example dot com>

ORPort 9001
DirPort 9030

## The IP address or hostname for incoming connections (leave commented and Tor will guess)
#Address noname.example.com

## Set your bandwidth rate (leave commented and Tor will run without bandwidth caps)
#RelayBandwidthRate 30 MBytes
#RelayBandwidthBurst 100 MBytes

## If you control multiple relays, include then in the family
#MyFamily $keyid,$keyid,...
  1. Run "service tor reload" (as root)
  2. After your relay connects to the network, it will try to determine whether the ports you configured are reachable from the outside. This step is usually fast, but it may take a few minutes. Look for a log entry in your /var/log/syslog such as "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 the IP and ports you specified in your torrc are correct, etc.

When it confirms that it's reachable, it will upload a "server descriptor" to the directory authorities to let clients know what address, ports, keys, etc your relay is using. After a few hours (to give it enough time to propagate), you can query Atlas to see whether your relay has successfully registered in the network. If it hasn't, re-check firewalls, IP and ports again.

  1. Consider if you'd like to switch to the Reduced exit policy.

How do I run a middle or guard relay on FreeBSD or HardenedBSD?

  1. Run "pkg install tor" (as root).
  2. Make sure your clock, date, and timezone are set correctly. Enabling ntpd is suggested.
  3. Edit /usr/local/etc/tor/torrc to look like the following:
    ## Set the nickname of this relay
    Nickname ididnteditheconfig
    
    ## Set your own contact info
    ContactInfo 0xFFFFFFFF Random Person <nobody AT example dot com>
    
    ORPort 9001
    DirPort 9030
    
    ## Set your bandwidth rate (leave commented and Tor will run without bandwidth caps)
    #RelayBandwidthRate 30 MBytes
    #RelayBandwidthBurst 100 MBytes
    
    ExitPolicy reject *:*
    
    ## If you control multiple relays, include then in the family
    #MyFamily $keyid,$keyid,...
    
    RunAsDaemon 1
    Log notice file /var/log/tor/notices.log
    
  4. Make sure tor starts on boot by running "sysrc tor_enable=YES" (as root)
  5. Run "service tor start" (as root)
  6. After your relay connects to the network, it will try to determine whether the ports you configured are reachable from the outside. This step is usually fast, but it may take a few minutes. Look for a log entry in /var/log/tor/notices.log such as "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 the IP and ports you specified in your torrc are correct, etc.

When it confirms that it's reachable, it will upload a "server descriptor" to the directory authorities to let clients know what address, ports, keys, etc your relay is using. After a few hours (to give it enough time to propagate), you can query Atlas to see whether your relay has successfully registered in the network. If it hasn't, re-check firewalls, IP and ports again.

How do I make sure that I'm using the correct packages on Ubuntu?

  1. Do not use the packages in Ubuntu's repositories. They are not reliably updated. If you use them, you will miss important stability and security fixes.
  1. Determine your Ubuntu version by running the following command:
    lsb_release -c
    
  1. As root, add the following lines to /etc/apt/sources.list. Use the version you found in step 2 for <version>.
    deb http://deb.torproject.org/torproject.org <version> main
    deb-src http://deb.torproject.org/torproject.org <version> main
    
  1. Add the gpg key used to sign the packages by running the following commands:
    gpg --keyserver keys.gnupg.net --recv A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89
    gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
    
  1. Run the following commands to install tor and check its signatures:
    sudo apt-get update
    sudo apt-get install tor deb.torproject.org-keyring
    

What is a bridge?

Bridge relays are Tor relays that are not listed in the public Tor directory. That means that ISPs or governments trying to block access to the Tor network can't simply block all bridges. Bridges are useful for Tor users under oppressive regimes, and for people who want an extra layer of security because they're worried somebody will recognize that they are contacting a public Tor relay IP address.

A bridge is just a normal relay with a slightly different configuration. See (link to How do I run a bridge) for instructions.

Several countries, including China and Iran, have found ways to detect and block connections to Tor bridges. Obfsproxy bridges address this by adding another layer of obfuscation.

Setting up an obfsproxy bridge requires an additional software package and additional configurations. See https://www.torproject.org/docs/pluggable-transports.html.en.

How do I run a obfs4 bridge on Debian?

  1. Run "apt-get install tor obfs4proxy" (as root).
  2. Make sure your clock, date, and timezone are set correctly. Install the ntp or openntpd (or similar) package to keep it that way.
  3. Edit /etc/tor/torrc to look like the following:
    ## The IP address or hostname for incoming connections (leave commented
    and Tor will guess)
    #Address noname.example.com
    
    ## Set the nickname of this relay
    Nickname ididnteditheconfig
    
    ## Set your own contact info
    ContactInfo 0xFFFFFFFF Random Person <nobody AT example dot com>
    
    BridgeRelay 1
    ServerTransportPlugin obfs4 exec /usr/bin/obfs4proxy
    ExtORPort auto
    ORPort 9001
    
    ## Set your bandwidth rate (leave commented and Tor will run without
    bandwidth caps)
    #RelayBandwidthRate 30 MBytes
    #RelayBandwidthBurst 100 MBytes
    
  4. Run "service tor reload" (as root)
  5. After your relay connects to the network, it will try to determine

whether the ports you configured are reachable from the outside. This step is usually fast, but it may take a few minutes. Look for a log entry in /var/log/syslog such as "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 the IP and ports you specified in your torrc are correct, etc. You should also see the message "Registered server transport 'obfs4'" indicating that obfs4proxy is functional.

Should I run an exit relay from home?

No. If law enforcement becomes interested in traffic from your exit relay, it's possible that officers will seize your computer. For that reason, it's best not to run your exit relay in your home or using your home Internet connection. Instead, consider running your exit relay in a commercial facility that is supportive of Tor. Have a separate IP address for your exit relay, and don't route your own traffic through it. Of course, you should avoid keeping any sensitive or personal information on the computer hosting your exit relay, and you never should use that machine for any illegal purpose.

Onions

I've heard about websites that are only accessible over Tor. What are these websites, and how can I access them?

Websites that are only accessible over Tor are called "onions" and end in the TLD .onion. For example, the DuckDuckGoOnion is https://3g2upl4pq6kufc4m.onion. You can access these websites by using Tor Browser. The addresses must be shared with you by the website host, as onions are not indexed in search engines in the typical way that vanilla websites are.

What is a .onion?

Tor makes it possible for users to hide their locations while offering various kinds of services, such as web publishing or an instant messaging server. Using Tor "rendezvous points," other Tor users can connect to these onion services, each without knowing the other's network identity.

These services use the special-use tld .onion (instead of .com,.net,.org,etc..) and are only accessible through the Tor network.

I cannot reach X.onion!

If you cannot reach the onion service you desire, make sure that you have entered the 16-character onion address correctly: even a small mistake will stop Tor Browser from being able to reach the site. If you are still unable to connect to the onion service, please try again later. There may be a temporary connection issue, or the site operators may have allowed it to go offline without warning.

You can also ensure that you're able to access other onion services by connecting to DuckDuckGo's Onion Service.

Misc

I have a compelling reason to trace a Tor user. Can you help?

There is nothing the Tor developers can do to trace Tor users. The same protections that keep bad people from breaking Tor's anonymity also prevent us from figuring out what's going on.

I'm receiving the error "could not connect to control port Tor"

For macOS and Linux: The issue is that a version of TorBrowser was released with a problem/feature that configuration files could not cope with space-characters in pathnames. Unfortunately macOS likes to store configuration data in a folder called "$HOME/Library/Application[SPACE]Support" - and there are a lot of other directory names with spaces in them, in your OSX Library folder. I can't recall precisely what I did to fix this, other than to manually check for anything Tor-related in my Library folder: find ~/Library/ | egrep -i 'tor(project|browser)' ...and delete it; subsequent versions of the browser will stop picking up old, poisonous configuration files that way. DO NOT do this blindly because it will delete your bookmarks too. Copy those to a safe place, first. [See https://tor.stackexchange.com/questions/13119/mac-osx-10-12-sierra-tor-cannot-connect-to-control-port-mac-os-sierra-fix/13288#13288 for one answer] xxx I need to test this on macOS before we publish it cause I don't know if it's still accurate

Can I use Tor with bittorrent?

We do not recommend using Tor with bittorrent. For further details, please see our blog post on the subject.

The files on my computer have been locked, and someone is demanding I download Tor Browser to pay a ransom for my files!

We are so sorry, but you have been infected with malware. The Tor Project did not create this malware. The malware authors are asking you to download Tor Browser presumably to contact them anonymously with the ransom they're demanding from you. If this is your first introduction to Tor Browser, we understand that you might think we're bad people who enable even worse people. But please consider that our software is used every day for a wide variety of purposes by ​human rights activists, journalists, domestic violence survivors, whistleblowers, law enforcement officers, and many others. Unfortunately, the protection that our software can provide to these groups of people can also be abused by criminals and malware authors. The Tor Project does not support or condone the use of our software for malicious purposes.

Does Tor keep logs?

Tor doesn't keep any logs that could identify a particular user. We do take some safe measurements of how the network functions, which you can check out here: metrics.torproject.org.

Does Tor Project offer email service or other privacy protecting web services?

No, we don't provide any online services. A list of all of our software projects can be found on our projects page.

Can I use the Tor logo in my product?

You can read all about that on our Trademark faq page.

I'm having a problem updating or using Vidalia

Vidalia is no longer maintained or supported. A large portion of the features Vidalia offered have now been integrated into Tor Browser itself.

Does the Tor Project offer hosting?

No, the Tor Project does not offer hosting services.

Can I change the number of hops Tor uses?

Right now the path length is hard-coded at 3 plus the number of nodes in your path that are sensitive. That is, in normal cases it's 3, but for example if you're accessing an onion service or a ".exit" address it could be more.

We don't want to encourage people to use paths longer than this as it increases load on the network without (as far as we can tell) providing any more security. Also, using paths longer than 3 could harm anonymity, first because it makes denial of security attacks easier, and second because it could act as an identifier if only a small number of users have the same path length as you.

How can I share files anonymously through Tor?

Many exit nodes are configured to block certain types of file sharing traffic, such as bittorrent. Bittorrent in specific is not anonymous over Tor.

For sharing files through Tor, OnionShare is a good option.

Contact

Don't see your question answered here? The best way to contact the Tor support team is to reach out to us on IRC in #tor on OFTC. If you've never been on IRC before, here are some instructions to get started. These instructions are for a Mozilla IRC server, so instead of irc.mozilla.org you'll use OFTC. The OFTC server addresses are: irc.oftc.net:6667 (alternative ports: 6668-6670, 7000) or irc.oftc.net:6697 for SSL (alternative port: 9999) (we recommend SSL).

Once you get connected and create a nickname, you can join the channel #tor. More info on getting started on IRC. and here's some info on IRC conventions and etiquette. Once you're on the channel, simply ask your question, be patient, and whoever is available will help you

How do I volunteer with Tor Project?

Please see our volunteering page for how to get involved!

How do I reach the Tor Project press person?

Sending an email to press@… is the best way to reach a press person.

How do I report a bug or some other issue?

Bug reporting is done through filing tickets on our bug tracker. Unless it is a security bug, then email tor-security@….

Can I use a VPN with Tor?

Generally speaking, we don't recommend using a VPN with Tor unless you're an advanced user who knows how to configure both in a way that doesn't compromise your privacy. You can find more detailed information about Tor + VPN here. https://trac.torproject.org/projects/tor/wiki/doc/TorPlusVPN

Last modified 3 weeks ago Last modified on Oct 2, 2017, 8:55:24 PM