Skip to content

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.

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=0

It 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.

Public bridgePrivate bridge
Where it comes fromThe Tor Project hands it out to many peopleA person gives it to you directly
Who knows the addressThousands of users, and any censor who asks for lines tooOnly the few people it was given to
How long it lastsOften days or weeks before it’s blockedUntil 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.

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:

  1. 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.
  2. On the Connect to Tor screen, click Configure Connection….
  3. In the Bridges section, under Add bridges, click Enter bridge addresses you already know.
  4. Paste your bridge line into the box (Paste your bridge addresses here). Each line goes on its own line.
  5. Click Next, then Connect.

If Tor Browser is already open:

  1. Open the menu (≡) and click Settings.
  2. Click Connection in the sidebar.
  3. 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.

  • 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.

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:

  1. Install Orbot from Google Play or orbot.app.
  2. On the main screen, tap Choose How To Connect.
  3. Select Custom Bridges and tap Next.
  4. Paste your line into Enter bridge address (or tap the scan button if you were given a QR code).
  5. Tap Connect. When it’s ready, Orbot shows Connected.

iOS / iPadOS:

  1. Install Orbot from the App Store.
  2. On the main screen, tap Choose How to Connect.
  3. Select Custom Bridges and tap Next.
  4. Paste your line into Enter bridge address (or scan a bridge QR code), then tap Save.
  5. 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.

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.

This is true of any obfs4 bridge, not just yours.

The bridge can seeThe bridge cannot see
Your IP address, while you’re connectedWhich websites you visit
When you connect and roughly how much data you sendWhat 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 SafeLogging setting.
  • 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.

Likely causeWhat you’ll noticeWhat to do
The line was blockedIt worked before, now it stalls while connectingAsk the person who gave it to you for a new line
The bridge is offlineFails quickly, for everyone using that lineWait a bit, then ask for a new line
The line was pasted wrong“Incorrectly formatted bridge address”, or it never connectsCopy it again as one unbroken line, with no extra spaces
Your device clock is wrongTor won’t finish connecting even on an open networkSet 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.

Recent changes

  1. docs(privacy): travel and shutdown prep pages; bot travel, multi-device and onion lines @sac
  2. docs(wiki): volunteer your bandwidth to people under censorship @sac
  3. docs(wiki): using a private Tor bridge @sac