Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Table of Contents
- I'm stuck on the loading screen
- Can I use this to access <Netflix, Pandora, BBC streaming, other streaming service, etc.>?
- How do I access <Silk Road, BlackMarket, other onion site, etc.>?
- I'm having trouble accessing <name of hidden service>.
I'm stuck on the loading screen
Try force-quitting the app and opening it again.
(Your network provider may be blocking connections to Tor. If you are an advanced Tor user and would like to try using "bridge" nodes to access Tor: see the Using Bridges section below.)
Can I use this to access <Netflix, Pandora, BBC streaming, other streaming service, etc.>?
No. These services generally require using a dedicated app (instead of a web browser) to access streaming content on mobile devices. Using Onion Browser to access these streams is not supported, and attempts to use these sites may reveal your real IP address.
How do I access <Silk Road, BlackMarket, other onion site, etc.>?
Due to the secrecy of some onion sites and the semi-random “.onion” domain name, it is often hard to know the address of the site you’re looking for and if the site you’re going to is the real deal or if it’s a fake.
We do not provide a directory for “.onion’ websites and cannot direct you to the onion site you are asking about. For what it’s worth, Onion Browser does come with several built-in bookmarks, including several well-known onion sites.
I'm having trouble accessing <name of hidden service>.
First make sure your iOS device is updating it's time automatically (Settings→General→Date & Time→Set Automatically), since connections to .onion sites require accurate system time.
Second, try accessing another hidden service — such as the hidden service for the Onion Browser website (
tigas3l7uusztiqu.onion/onionbrowser) or the hidden service for the Tor Project website (
idnxcnkne4qt76tg.onion) — to see if it's an issue with the hidden service you're trying to use. If you can connect to other services, the one you are trying to access may actually be offline — which is not an Onion Browser issue.
As mentioned the Tor Help Desk Roundup in this post, "Hidden services are solely under the responsibility of their operators and they are the only one that can do something when a hidden service goes offline."
If you are in an area where Tor traffic might be blocked, bridges might help with connection issues. (Note, networks and countries that block Tor via deep packet inspection will still render the app unusable.) For more information, read the Tor Project's documentation on bridges.
You can add bridges to Onion Browser in a couple ways:
- The first time you open Onion Browser: Press "Use Bridges" on the screen that mentions bridges.
- While connecting as the app starts up: Press the gear icon in the upper-right of the loading screen.
- Any time after the app has initially connected: Press the "options" button in the toolbar and click on "Bridge Configuration".
We recommend the use of the built-in "obfs4" and "meek" bridges. If you still can't connect, you can try using custom bridges that you can get from the Tor Project website:
Visit https://bridges.torproject.org/ and complete the CAPTCHA on the page. You will then see a page (like the image below) that contains several "bridge lines". You can copy this text and send it to yourself. Alternatively, you can click the "Show QR Code" button and open and use your iPhone camera to use the QR code (in step 4 below).
Open the Bridges menu as per the bullet points above.
If you find that the app still gets stuck while conncting, go back to the bridges menu, double-check your work, and then restart the app. You can also try switching back to "No Bridges" or try another one of the built-in bridge types.