When Tor onion links fail to load, check the error code Tor Browser displays—it tells you exactly what went wrong. Error 0xF6 means the onion address itself is invalid (1). Valid v3 addresses must be exactly 56 characters long (2), and addresses shorter than that are old v2 format no longer supported (2). Errors 0xF0 and 0xF2 most likely mean the site is offline (1). Error 0xF1 indicates an internal server error (1), while 0xF3 means the site is busy or the Tor network is overloaded (1). To test whether your Tor connection works, visit known-working onion services recommended by the Tor Project (2). If those load but your target site doesn't, the problem is with that specific site. You can copy the Tor log from the error message for technical details (3).
Understanding Tor Browser Error Codes
Tor Browser shows specific error codes when onion links fail. Each code points to a different cause.
Error 0xF0 "Onionsite Not Found" most likely means the site is offline (1). Error 0xF1 "Onionsite Cannot Be Reached" indicates the site is unreachable due to an internal error (1). Error 0xF2 "Onionsite Has Disconnected" also most likely means the site is offline (1).
Error 0xF3 "Unable to Connect to Onionsite" indicates the site is busy or the Tor network is overloaded (1). This happens when too many users try to connect at once or when network relays are under heavy load.
Error 0xF4 "Onionsite Requires Authentication" means access requires a key but none was provided (1). Error 0xF5 "Onionsite Authentication Failed" indicates the provided key is incorrect or has been revoked (1). These codes appear only for private onion services that require invitation.
Error 0xF6 "Invalid Onionsite Address" means the address format itself is wrong (1). This happens when the address contains typos, missing characters, or uses an outdated format.
Check If the Onion Address Is Valid
A valid v3 onion address must be exactly 56 characters long (2). Even a single typo will prevent Tor Browser from connecting to the site (2).
Count the characters in the address between "http://" and ".onion". If you see fewer than 56 characters, the address uses the older v2 format. Onion addresses shorter than 56 characters belong to v2 format, which is no longer supported by the Tor network (2). Those sites are effectively gone.
If you see error 0xF6, check the address carefully:
Copy the address into a text editor and count characters
Look for spaces, extra dots, or missing letters
Verify the address ends with ".onion"
Compare with the original source where you found the link
V3 addresses contain only lowercase letters and numbers 2-7. Any uppercase letters, symbols, or numbers 8-9 indicate a typo or invalid address.
Test with Known-Working Onion Sites
The Tor Project recommends testing connectivity by visiting known-working onion services such as DuckDuckGo's onion service or Tor Project's onion service (2). This helps you determine whether the problem is with your connection or the specific site.
Try these steps:
Open Tor Browser
Visit a known-working onion service
Wait for the connection to establish
Note whether the page loads successfully
If known-working sites load successfully, the problem is specific to your original onion site. The site is likely offline, moved, or permanently shut down. If test sites also fail to load, the issue is with your Tor connection or network.
Check your Tor connection status in the browser. The onion icon in the address bar should show "Connected to Tor" when you click it. If it shows connection problems, restart Tor Browser and try again.
You can find addresses for known-working onion services in verified onion link directories that list currently accessible sites.
When the Onion Site Is Offline or Unreachable
Error codes 0xF0 "Onionsite Not Found" and 0xF2 "Has Disconnected" most likely mean the site is offline (1). Onion sites can go offline without notice. There is no centralized uptime guarantee.
Error 0xF1 "Cannot Be Reached" indicates an internal server error (1). The site's server is running but cannot process requests properly. This usually requires the site operator to fix the problem.
Error 0xF3 "Unable to Connect" means the site is busy or the Tor network is overloaded (1). Wait and try again later. Peak usage times can slow down both individual sites and the entire Tor network.
What you can do:
Wait several hours and retry the address
Check if the site has announced downtime or migration
Look for alternative mirrors if the site provides them
Search for updated addresses in onion link directories
Onion sites often move to new addresses without redirects. The old address simply stops working. If a site has been unreachable for several days, it may have moved or shut down permanently.
Using Tor Logs to Diagnose Connection Problems
When Tor Browser shows an error message, you can copy the Tor log to clipboard to help diagnose the problem (3). The log provides technical details about what went wrong during the connection attempt.
To access the log:
Look for "Copy Tor Log" button on the error page
Click the button to copy log contents
Paste into a text editor to review
The log reveals whether the issue is address-related, network-related, or service-related. Look for these indicators:
"Invalid hostname" means the address format is wrong
"Connection refused" indicates the site rejected the connection
"Timeout" means the site didn't respond within the allowed time
"Circuit build timeout" points to Tor network congestion
The log shows which Tor relays your connection attempted to use. If the same relay appears in multiple failed attempts, that relay may be experiencing problems. Restarting Tor Browser forces it to select different relays.
You can share the log when asking for help in Tor community forums. Remove any personal information before sharing. The log does not contain your IP address but may show your Tor Browser version and operating system.
Why won't Tor Browser work? If Tor Browser won't connect to any onion sites, test with known-working onion services recommended by the Tor Project (2). If those also fail, check your Tor connection status by clicking the onion icon in the address bar. Restart Tor Browser to force new relay selection.
How to access .onion sites? You need Tor Browser to access .onion sites. Verify the onion address is exactly 56 characters long (2) and uses v3 format. Addresses shorter than 56 characters are v2 format no longer supported (2).
What does 'Onion Site Not Found' mean? Error 0xF0 "Onionsite Not Found" most likely means the site is offline (1). Wait several hours and retry, or look for alternative mirrors or updated addresses.
How do I know if a hidden service is down? Test your connection with known-working onion services (2). If those load but your target site shows error 0xF0, 0xF2, or 0xF1 (1), the specific site is offline or experiencing server problems.
References
[1] Onion services - Features - Tor Browser — Tor
[2] Problem reaching an onion site - Encountering issues - Tor Browser — Tor
[3] Troubleshooting - Encountering issues - Tor Browser — Tor
Q&A
- Why can't I connect to onion sites?
Check the error code Tor Browser displays: 0xF6 means the address format is invalid (1), 0xF0 and 0xF2 mean the site is most likely offline (1), 0xF3 means the site is busy or the Tor network is overloaded (1), and 0xF1 indicates an internal server error (1). Test your connection by visiting known-working onion services recommended by the Tor Project (2).
- Why are short onion addresses not working anymore?
Onion addresses shorter than 56 characters belong to the older v2 format, which is no longer supported by the Tor network and those sites are effectively gone (2). Valid v3 addresses must be exactly 56 characters long (2).
Where to look next
These services are useful starting points for further research. Tools & services.