Tor Browser manual

Defend yourself against tracking and surveillance. Circumvent censorship. The Tor Browser user manual guides you through getting started, configuring censorship circumvention, exploring key features like fingerprinting protections and onion services, and troubleshooting common issues.

Getting started

Understand the basics of Tor Browser.

Censorship circumvention

What to do if the Tor network is blocked.

Features

Explore Tor Browser private browsing.

Encountering issues

Troubleshooting Tor Browser

General

General FAQ

Security

This section contains common questions regarding safety and reliability of Tor Browser

What is Tor Browser and how does it work?

Tor Browser is a privacy-focused web browser that routes your traffic through the Tor network, hiding your real IP address, preventing tracking, and protecting you against surveillance and censorship. Tor Browser uses the Tor network to protect your privacy and anonymity.

About Tor Browser
How Tor works

How Tor works

How to download Tor Browser

The safest way to download Tor Browser is from the official website. If it's blocked, use our official mirrors or GetTor.

Downloading

How to install Tor Browser

Tor Browser is available for Android, Windows, macOS, and Linux. This section explains the system requirements and installation steps for each platform.

View for:
Windows macOS Linux Android iOS
Windows
macOS
Linux
Android
iOS

Running Tor Browser for the first time.

Learn how to set your display language, connect to the Tor network, use Connection Assist, and configure bridges or proxies when starting Tor Browser for the first time.

View for:
Desktop Android
Desktop
Change Tor Browser's display language

Change Tor Browser's display language

Select display language of Tor Browser

Select display language of Tor Browser

Click 'connect' to connect to Tor

Click 'connect' to connect to Tor

Click 'Configure Connection' to adjust network settings

Click 'Configure Connection' to adjust network settings

Connection Assist automatic

Connection Assist automatic

Connection Assist configuration

Connection Assist configuration

Connection Test success

Connection Test success

Connection Test unsuccessful

Connection Test unsuccessful

Connect Automatically

Connect Automatically

Configure Tor bridge

Configure Tor bridge

Proxy settings for Tor Browser

Proxy settings for Tor Browser

Android
Connect to Tor Browser for Android

Connect to Tor Browser for Android

Connection Assist for Tor Browser Android

Connection Assist for Tor Browser Android

How to keep Tor Browser up to date

Keep Tor Browser updated to protect your privacy and security. Using an outdated Tor Browser puts you at risk of serious vulnerabilities and deanonymization.

View for:
Desktop Android
Desktop
Prompt to update Tor Browser Desktop

Prompt to update Tor Browser Desktop

Update progress bar

Update progress bar

Android
Updating Tor Browser for Android on Google Play

Updating Tor Browser for Android on Google Play

Updating Tor Browser for Android on F-Droid

Updating Tor Browser for Android on F-Droid

Running Tor Browser from a USB stick or SD card

If preferred, Tor Browser may be made portable by extracting it from its archive directly onto removable media such as a USB stick or SD card. It is recommended to use writable media so that Tor Browser can be updated as required.

View for:
Windows macOS Linux
Windows
macOS
Linux

Getting Tor Browser in your preferred language

Tor Browser is available in many languages. You can select your preferred language when installing or running Tor Browser, and you can help us add more through translation.

Language support

How to uninstall Tor Browser

Tor Browser does not integrate with your system's standard uninstall utilities. Instead, removal is as simple as deleting the Tor Browser folder or application and any related data. Follow the instructions below to completely remove Tor Browser from your device.

View for:
Windows macOS Linux Android
Windows
macOS
Go to folder menu option

Go to folder menu option

Go to folder window

Go to folder window

Linux
Android
Uninstalling Tor Browser for Android on Google Play

Uninstalling Tor Browser for Android on Google Play

Uninstalling Tor Browser for Android on F-Droid

Uninstalling Tor Browser for Android on F-Droid

Uninstalling Tor Browser for Android using device app settings

Uninstalling Tor Browser for Android using device app settings

How to verify Tor Browser's signature

A digital signature is a process that ensures a package was generated by its developers and has not been tampered with. Below we explain why it is important and how to verify that the Tor Browser you download is the one we created and has not been modified by an attacker.

View for:
Windows macOS Linux
Windows
macOS
Linux

What to do if access to Tor is blocked?

Direct access to the Tor network may sometimes be blocked by your Internet Service Provider or by a government. Tor Browser includes some circumvention tools for getting around these blocks. These tools are called "pluggable transports".

Pluggable Transport
Configure built-in bridges

Configure built-in bridges

Configure Tor Browser to use bridges

Learn how to configure Tor Browser to use bridges on desktop and Android. Bridges are alternative entry nodes to the Tor network that help bypass censorship when direct connections are blocked.

View for:
Desktop Android
Desktop
Enter bridge addresses manually

Enter bridge addresses manually

Bridge-moji

Bridge-moji

Bridge QR code

Bridge QR code

Android
Provide a bridge on Tor Browser for Android

Provide a bridge on Tor Browser for Android

Provide bridge addresses on Tor Browser for Android

Provide bridge addresses on Tor Browser for Android

Where to find Tor bridges?

Because bridge addresses are not public, you will need to request them yourself. You have a few options: moat (inside Tor Browser), the Tor Project website, our Telegram bot, or email.

View for:
Moat Website Telegram Bot Email
Moat
Website
Telegram Bot
Email

How to bypass censorship and connect to Tor from different countries or regions

In some countries, Internet service providers or national firewalls block direct access to the Tor network. Tor Browser includes built-in support for bridges and other circumvention tools, but in censored regions you may still need to select or request a bridge to connect successfully. This page offers country-specific guidance on getting Tor Browser connected when access is censored.

View for:
China Russia Turkmenistan Belarus
China
Russia
Turkmenistan
Belarus

How Tor Browser protects you against browser fingerprinting

Websites can use browser fingerprinting to track users without cookies. Tor Browser includes multiple defenses - like letterboxing, user-agent spoofing, and first-party isolation - that make it harder to identify you online.

Fingerprinting protections
letterboxing

letterboxing

Managing identities and preventing linkability in Tor Browser

When you connect to a website, it is not only the operators of that website who can record information about your visit. Most websites now use numerous third-party services, including social networking "Like" buttons, analytics trackers, and advertising beacons, all of which can link your activity across different sites.

Managing identities
Display circuit diagram under the site information menu

Display circuit diagram under the site information menu

New Identity and New Tor Circuit options under main menu

New Identity and New Tor Circuit options under main menu

Enforcing encrypted browsing with HTTPS-Only Mode

Tor Browser includes HTTPS-Only Mode, which ensures your connections to websites are always encrypted whenever possible. This helps prevent eavesdropping, tampering, and man-in-the-middle attacks that can occur on unencrypted HTTP connections.

HTTPS-Only
HTTPS-only mode setting in Tor Browser

HTTPS-only mode setting in Tor Browser

Warning about Secure Connection not available when visiting HTTP website

Warning about Secure Connection not available when visiting HTTP website

Cryptocurrency safety dialog

Cryptocurrency safety dialog

HTTPS and Tor work together to enhance your privacy and anonymity

Learn more

Adjusting security levels in Tor Browser to balance privacy and usability

By default, Tor Browser protects your security by encrypting your browsing data. To maintain usability, JavaScript is enabled by default. You can further increase your security by choosing to disable JavaScript and certain web features that can be used to compromise your security and anonymity. You can do this by increasing Tor Browser's Security Level.

View for:
Desktop Android
Desktop
Access Security Level Settings

Access Security Level Settings

Save the settings and restart the browser

Save the settings and restart the browser

Android
Access Security Level Settings

Access Security Level Settings

Change the Security Level

Change the Security Level

Save the settings and restart the browser

Save the settings and restart the browser

Can I use plugins, add-ons, or extensions in Tor Browser?

Tor Browser includes NoScript by default to help control JavaScript, but installing other plugins or add-ons is strongly discouraged because they can harm your privacy, weaken security, and make you easier to track.

Desktop

Understanding and using onion services in Tor Browser

Onion services (formerly known as "hidden services") are services, like websites, that are only accessible through the Tor network.

Onion Services
Onion Icon

Onion Icon

Onion-Location

Onion-Location

Onion service served over HTTP or HTTPS.

Onion service served over HTTP or HTTPS.

Onion service is served over an insecure URL.

Onion service is served over an insecure URL.

Onion service with an expired certificate, wrong domain or served over an insecure URL.

Onion service with an expired certificate, wrong domain or served over an insecure URL.

Client Authorization

Client Authorization

Why is DuckDuckGo the default search engine in Tor Browser?

Tor Browser uses DuckDuckGo as its default search engine because it does not log or share personal information, making it better aligned with Tor's privacy goals.

DuckDuckGo

Troubleshooting connection and usage issues in Tor Browser

It is important to know what version of Tor Browser you have installed and to fetch the Tor Logs in order to troubleshoot a problem with the browser. These are important information to share when raising a support ticket or filing a bug report.

View for:
Desktop Android
Desktop
Click 'Connect' to connect to Tor

Click 'Connect' to connect to Tor

Connection Assist Test

Connection Assist Test

Connection Assist offline error

Connection Assist offline error

Android
View Tor logs on Tor Browser for Android

View Tor logs on Tor Browser for Android

Known issues and limitations in Tor Browser

These are common issues that can prevent Tor Browser from working.

View for:
Desktop Android
Desktop
Android

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

Most antivirus or malware protection allows the user to "allowlist" certain processes that would otherwise be blocked.

Desktop

Gmail warns me that my account may have been compromised

When you log into Gmail with Tor Browser, Google may warn you that your account was accessed from unusual locations. This is usually a false alarm caused by Tor's exit relays, but you should still take steps to secure your account.

Gmail

I'm supposed to "edit my torrc". What does that mean?

The torrc file contains Tor’s configuration options. Most users should not edit it, since unsafe changes can compromise your privacy and security.

View for:
General Windows macOS Linux
General
Windows
macOS
Linux

Why do websites make me solve CAPTCHAs or warn me about spyware when using Tor?

Some websites require Tor users to solve CAPTCHAs or display warnings about unusual activity. This happens because many people share the same Tor exit relays, not because Tor itself is unsafe.

Captchas

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

Some websites interpret Tor connections as suspicious logins and may lock accounts. Recovery usually requires following the site’s procedure, but enabling two-factor authentication can help reduce future lockouts.

Website account lockouts

How to read and troubleshoot common Tor log errors

Tor logs can help diagnose connection problems. This article explains common log errors and how to fix them, such as adjusting proxy settings, correcting your system clock, or using bridges on censored networks.

Tor logs

What to do if you can't reach an onion site

If an onion site won't load, first double-check the 56-character address - even a single typo will prevent Tor Browser from connecting. Sometimes onion services go offline temporarily or permanently, so trying again later or testing another known onion site can help you determine if the problem is on your end.

Problem reaching an onion site

How to fix the "Proxy Server Is Refusing Connection" error in Tor Browser

This error can appear for several reasons, from antivirus interference to incorrect ports or a corrupted installation. This article lists common causes and steps you can take to resolve the issue before contacting Tor support.

Proxy server error

Are there any paid versions of Tor Browser?

Tor Browser is an open source software and it is free.

Cost to use Tor

How can I export and import bookmarks in Tor Browser?

Manage your bookmarks in Tor Browser by exporting, importing, backing up, or restoring them on Desktop; Android does not yet support these features.

View for:
Desktop Android
Desktop
Android

What is the difference between using Tor Browser and Incognito mode or private tabs?

While the names may imply otherwise, 'Incognito mode' and 'private tabs' do not make you anonymous on the Internet.

Desktop

A website I am trying to reach is blocking access over Tor.

Sometimes websites block Tor users because they can't tell the difference between the average Tor user and automated traffic.

Blocking Tor

How can I make Tor run faster? Is Tor Browser slower than other browsers?

Tor Browser may feel slower than other browsers because traffic is routed through relays around the world. Performance depends on network load, latency, and ongoing defenses against attacks.

Tor Browser speed

Why does Google show up in foreign languages?

Foreign languages

Using Tor Browser with a VPN

While it might seem like combining a VPN with Tor would increase privacy, in practice it can reduce anonymity or break Tor's protections if not configured correctly.

Tor Browser with VPN

Can I use Tor with a browser besides Tor Browser?

We strongly recommend against using Tor in any browser other than Tor Browser.

Tor

Am I totally anonymous if I use Tor Browser?

Tor Browser includes many privacy protections, but it cannot guarantee perfect anonymity. Follow these best practices to reduce risks and stay safer online.

Tor Browser

Why does the first IP address in my Tor circuit always stay the same?

Tor selects a stable and trusted "guard relay" to be the first hop in your circuit. This guard usually remains the same for several months to protect you from certain anonymity-breaking attacks.

Guard relay

Why Tor Browser for Android is being reported to have trackers?

Some privacy-scanning tools list trackers in Tor Browser for Android because the app is based on Firefox for Android. However, all tracking components are disabled by default, and plans are underway to completely remove the remaining code.

Tor Browser for Android

Why did Tor Browser drop support for legacy operating systems?

Legacy unsupported operating systems receive no security updates and may have known security vulnerabilities. They also lack the new features and functionalities required by Tor Browser.

Tor Browser

How to contact the Tor Project team to report bugs, security issues, or share feedback

There are different ways you can contact the Tor Project and what information to include to help us resolve your issue quickly.

Reporting issues

How to get help, report a bug or give feedback to the Tor Project

Find out how to contact the Tor Project for support, bug reports, and feedback.

User support