Using a private Tor bridge
This page is for you if someone you trust has given you a bridge line and you want to use it. You don’t need to know how Tor works inside. For the bigger picture, read the Tor Network Guide first.
What a bridge is
Section titled “What a bridge is”Tor normally connects you to a public relay. The list of public relays is published, so a censor (a government, an ISP, a school or work network) can block every address on it.
A bridge is a Tor entry point that isn’t on that public list. Most bridges also use a pluggable transport such as obfs4, which makes the connection look like random data instead of Tor. Your network sees an encrypted connection to an ordinary address.
A bridge line looks like this. This example is fake and will not connect:
obfs4 192.0.2.10:443 0000000000000000000000000000000000000000 cert=EXAMPLE-ONLY-NOT-A-REAL-CERTIFICATE iat-mode=0It has the transport name, an address and port, the bridge’s fingerprint, and a key
(cert=). The whole thing is one line. Some lines start with webtunnel instead of
obfs4; you add those the same way.
Why a private bridge lasts longer
Section titled “Why a private bridge lasts longer”| Public bridge | Private bridge | |
|---|---|---|
| Where it comes from | The Tor Project hands it out to many people | A person gives it to you directly |
| Who knows the address | Thousands of users, and any censor who asks for lines too | Only the few people it was given to |
| How long it lasts | Often days or weeks before it’s blocked | Until someone leaks it, or the operator turns it off |
Censors collect public bridge lines the same way users do and block them. A private bridge is never handed out publicly, so there’s nothing for them to collect unless someone shares it.
Keep the line private
Section titled “Keep the line private”The line is the only thing that keeps the bridge hidden. Treat it like a key.
- Don’t post it or forward it. Not in a group chat, not in a screenshot, not in a public paste. If a friend needs a bridge, ask the person who gave you yours to give them their own.
- Censors block lines they find. Once a line appears somewhere public, assume it will stop working for everyone who uses it.
- One line per person. Many operators give each person a different line. If a line leaks, they can tell which one it was, turn it off, and give you a new one without breaking everyone else’s.
- Keep it in a private note or password manager, not in your camera roll.
Add it to Tor Browser (Windows, macOS, Linux)
Section titled “Add it to Tor Browser (Windows, macOS, Linux)”The steps are the same on all three systems. They match Tor Browser 16 and the Tor Project’s own instructions (Using bridges).
First time you open Tor Browser:
- Install Tor Browser from torproject.org/download. If that site is blocked, use the official mirrors or GetTor described in the Tor Project’s Downloading page.
- On the Connect to Tor screen, click Configure Connection….
- In the Bridges section, under Add bridges, click Enter bridge addresses you already know.
- Paste your bridge line into the box (Paste your bridge addresses here). Each line goes on its own line.
- Click Next, then Connect.
If Tor Browser is already open:
- Open the menu (≡) and click Settings.
- Click Connection in the sidebar.
- In Bridges, under Add bridges (or Replace your bridges if you already have some), click Enter bridge addresses you already know, paste the line, and click Next, then Connect.
If Tor Browser says Incorrectly formatted bridge address, the line was cut or wrapped when you copied it. Copy it again as a single line.
Check that it’s connected
Section titled “Check that it’s connected”- In Settings → Connection, the status reads Tor network: Connected, and your bridge appears under Your bridges.
- Visit check.torproject.org in Tor Browser. It should say Congratulations. “Sorry. You are not using Tor.” means something is wrong.
Add it to Orbot (Android and iOS)
Section titled “Add it to Orbot (Android and iOS)”Orbot is the Guardian Project’s Tor app for phones. It can route other apps through Tor. The labels below come from the current Orbot source code (Android, iOS); see also the Orbot FAQ.
Android:
- Install Orbot from Google Play or orbot.app.
- On the main screen, tap Choose How To Connect.
- Select Custom Bridges and tap Next.
- Paste your line into Enter bridge address (or tap the scan button if you were given a QR code).
- Tap Connect. When it’s ready, Orbot shows Connected.
iOS / iPadOS:
- Install Orbot from the App Store.
- On the main screen, tap Choose How to Connect.
- Select Custom Bridges and tap Next.
- Paste your line into Enter bridge address (or scan a bridge QR code), then tap Save.
- Tap Start on the main screen. When it’s ready, Orbot shows Connected.
To check from your phone, open check.torproject.org in a browser that goes through Orbot.
Once Tor works
Section titled “Once Tor works”Read this wiki over Tor. In Tor Browser or Onion Browser, open Irregularpedia’s onion site:
http://xkmibofmhy6e7pxf6o55ricdtluih4korwk5dasx6e65rqsfc34m7myd.onion/For other useful onion sites, open
http://xkmibofmhy6e7pxf6o55ricdtluih4korwk5dasx6e65rqsfc34m7myd.onion/general/darkweb-links/.
These addresses won’t open in a normal browser. The onion address may change; the current
one is always offered at the top of Irregularpedia in Tor Browser, as a purple
.onion available button in the address bar
(Tor Project: Onion-Location). The
Onion services page lists the community’s other onion sites.
What the bridge can and cannot see
Section titled “What the bridge can and cannot see”This is true of any obfs4 bridge, not just yours.
| The bridge can see | The bridge cannot see |
|---|---|
| Your IP address, while you’re connected | Which websites you visit |
| When you connect and roughly how much data you send | What you read, type or send |
| Your accounts or passwords |
Tor encrypts your traffic in layers before it reaches the bridge, and the bridge only passes it to the next relay. It sees that you’re using Tor, not what you’re doing.
Remember that the person who gave you the line knows who you are. If they also run the bridge, they could link your IP address to you while you’re connected.
What a well-run private bridge keeps:
- Logs in memory only, not written to disk.
- Addresses scrubbed from those logs. Tor does this by default with its
SafeLoggingsetting. - Only totals, such as how many people connected in a day, not a list of who.
Ask the person who gave you the line what they keep. A good operator will tell you plainly.
If it stops working
Section titled “If it stops working”| Likely cause | What you’ll notice | What to do |
|---|---|---|
| The line was blocked | It worked before, now it stalls while connecting | Ask the person who gave it to you for a new line |
| The bridge is offline | Fails quickly, for everyone using that line | Wait a bit, then ask for a new line |
| The line was pasted wrong | “Incorrectly formatted bridge address”, or it never connects | Copy it again as one unbroken line, with no extra spaces |
| Your device clock is wrong | Tor won’t finish connecting even on an open network | Set the date, time and time zone to automatic, then try again |
Fallback while you wait: use a built-in bridge. In Tor Browser, go to Settings → Connection, click Choose from one of Tor Browser’s built-in bridges, pick Snowflake, and connect (Tor Project instructions). In Orbot, pick Snowflake under Choose How To Connect. Snowflake is often slower, but it is hard for a censor to block. Switch back to your private line once you have a new one.
Related
Section titled “Related”- Tor Network Guide: Tor Browser, onion services, and common mistakes
- Proxies, VPN tunnels, and circumvention: obfs4 bridges with command-line Tor
- Bypassing VPN Blocks: when a network blocks VPNs
- VPN Recommendation: picking a VPN
- Travelling to a Censored Country: a checklist for before you leave, at the border and while you’re there
- Internet Shutdown Prep: what to install for when the whole internet goes off
- Volunteer your bandwidth: run Snowflake, Psiphon Conduit or a bridge to help others
- Tor Project support: bridges