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.
You should be able to start browsing the web using Tor Browser shortly after running the program, and clicking the "Connect" button if you are using it for the first time.
The Connection Assist informs you about the state of your Internet connection.
Check your Internet Connection if it says 'Offline'. If your connection to the Tor Network is not established and it reads 'Not Connected' the following steps can be helpful.
Check browser version
It is often important to know what version of Tor Browser you are using, to help you troubleshoot a problem or just to know if Tor Browser is up to date. This is important information to share when raising a support ticket.
- When you have Tor Browser running, click on "Settings" in the hamburger menu (≡).
- Scroll down to the "Tor Browser Updates" section where the version number is listed.
Quick fixes
If Tor Browser doesn't connect, there may be a simple solution. Try each of the following:
- Your computer's system clock must be set correctly, or Tor will not be able to connect.
- Make sure another Tor Browser or instance of 'Tor' is not already running on your system. If you're not sure if Tor Browser is running, restart your computer.
- Make sure that any antivirus program you have installed is not preventing Tor from running. You may need to consult the documentation for your antivirus software if you do not know how to do this.
- Temporarily disable your firewall.
- If Tor Browser was working before and is not working now your system may have been hibernating. A reboot of your system will solve the issue.
- Delete Tor Browser and install it again. If updating, do not just overwrite your previous Tor Browser files; ensure they are fully deleted beforehand.
View Tor logs
In most cases, taking a look at the Tor logs can be helpful in diagnosing the issue. If you're having trouble connecting, an error message may appear and you can select the option to "copy Tor log to clipboard". Then paste the Tor log into a text file or other document.
If you don't see this option and you have Tor Browser open, you can navigate to the hamburger menu ("≡"), then click on "Settings", and finally on "Connection" in the side bar. At the bottom of the page, next to the "View the Tor logs" text, click the button "View Logs...".
Alternatively, on GNU/Linux, to view the logs right in the terminal, navigate to the Tor Browser directory and launch Tor Browser from the command line by running:
./start-tor-browser.desktop --verbose
Or to save the logs to a file (default: tor-browser.log):
./start-tor-browser.desktop --log [file]
More information on this can be found on the Support Portal.
Is your connection censored?
If you still can't connect, your Internet Service Provider might be censoring connections to the Tor network. Read the Circumvention section for possible solutions.
Known issues
Tor Browser is under constant development, and some issues are known about but not yet fixed. Please check the Known Issues page to see if the problem you are experiencing is already listed there.
Check browser version
From the app:
- When you have Tor Browser for Android running, tap on 'Settings'.
- Scroll to the bottom of the page.
- Tap on 'About Tor Browser'.
- The version number should be listed on this page.
From Android menu:
- Navigate to Android's Settings.
- Tap on 'Apps' to open the list of apps installed on your device.
- Find 'Tor Browser' from the list of apps.
- Tap on 'Tor Browser'.
- Scroll down to the very bottom of the page where the version number will be listed.
View Tor Logs
- Tap on the settings icon or "Configure connection" when on the "Connect to Tor" screen.
- Navigate to the "Connection" section of the Settings.
- Tap on "Tor Logs".
- To copy the Tor logs to the clipboard, tap on the "Copy" button at the bottom of the screen.
To troubleshoot some of the most common issues by reading the logs, please refer to this Support Portal entry.