Troubleshooting
How to Set Up Tor Bridges
If the Tor Browser won't connect, a bridge is usually the answer. A bridge is a hidden way into the Tor network that helps you connect even when your internet provider, school, workplace, or country blocks Tor. Setting one up takes about a minute. This guide covers the built-in bridges, WebTunnel for heavy censorship, and what to do when a bridge stops working.
Quick answer
The quick version
Go to Settings → Connection, click “Choose from one of Tor Browser’s built-in bridges”, choose obfs4, and click Connect. If that fails, try Snowflake. In heavily censored countries like Russia, Iran, or China, let Connection Assist pick a bridge for you, or get a WebTunnel bridge from the official Telegram bot @GetBridgesBot. (In Russia, Telegram is blocked: see what works there.)
What is a Tor bridge (and when do you need one)?
Tor's normal entry points are public, which means some networks keep a list of them and block them. Bridges are unlisted entry points, and most of them also disguise your traffic so it doesn't look like Tor. That lets them slip through where a normal connection can't.
You only need a bridge if Tor is blocked where you are. If the Tor Browser connects fine without one, you don't need it, and turning a bridge on unnecessarily just makes your connection slower.
The easiest way: let Connection Assist choose
If Tor Browser fails to connect, it will often offer to fix the problem for you. This feature is called Connection Assist. With your permission, it uses your location to pick a bridge that is known to work in your country. For Russia, for example, it tries Snowflake, then WebTunnel, then obfs4.
-
Try to connect normally
If it fails, you'll see a message like “Tor Browser could not connect to Tor.”
-
Pick your location
Under “Unblock the Internet in”, leave it on Automatic or choose your country from the list.
-
Click “Try a Bridge”
Tor Browser downloads bridge settings that suit your country and tries them. This can take a minute, so let it finish.
Connection Assist is on desktop and, since 2025, on Android too. If it can't get you connected, set up a bridge by hand using the steps below.
How to set up a built-in bridge (step by step)
Tor Browser ships with three bridge types, so there's no copying or pasting. These steps match Tor Browser 16 on Windows, macOS, and Linux:
-
Open the connection settings
On the “Connect to Tor” screen, click Configure Connection…. If the browser is already open, go to ☰ menu → Settings → Connection, or type
about:preferences#connectionin the address bar. Click “Choose from one of Tor Browser’s built-in bridges”
You'll find it in the Bridges section, under “Add bridges” (or “Replace your bridges” if you added some before). It opens a small window called “Select a Built-In Bridge”.
-
Choose a bridge type
Pick obfs4 for most networks. If obfs4 is blocked where you are, pick Snowflake. Use meek only as a last resort, because it's slow.
-
Confirm and connect
Click Connect in that window (it says OK if Tor is already connected). “Use bridges” switches on by itself, and once it works, your bridge shows as Connected.
On Android
Tap Settings (⚙), then Config Bridge in the Connection section. Switch on “Use a Bridge” and choose obfs4, Snowflake, or meek. To paste a bridge you received, pick “Provide a Bridge I know”. (More in our Tor on Android guide.)
Which bridge type to choose: obfs4, Snowflake, WebTunnel, or meek
Each bridge type disguises Tor in a different way. Here's how they compare:
| Bridge | Disguise | Built in? | Best for |
|---|---|---|---|
| obfs4 | Random-looking data | Yes | Most networks. Try it first. |
| Snowflake | Looks like a video call, through volunteer proxies | Yes | When obfs4 is blocked. One of the most-used options in Iran. |
| WebTunnel | An ordinary visit to an HTTPS website | No, request one | Heavy censorship: Russia (especially on mobile data), Iran, China |
| meek | Traffic to a big content delivery network | Yes | Last resort. Usually very slow. |
A simple order to try: on most networks, obfs4 → Snowflake → meek. In heavily censored countries, start with Connection Assist, then try WebTunnel or Snowflake.
WebTunnel: the bridge for heavy censorship
WebTunnel is one of the newest bridge types, launched by the Tor Project in 2024. It makes your Tor connection look like a normal visit to an ordinary HTTPS website. That helps on networks that block anything they can't identify, including obfs4. The Tor Project recommends it in particular for mobile networks in Russia, where obfs4 is often blocked. WebTunnel isn't in the built-in list, so you need to request one. Here's how:
-
Get a WebTunnel bridge
On Telegram, open the official bot @GetBridgesBot and send
/webtunnel. Or go to bridges.torproject.org/options, choose webtunnel under “Advanced Options”, click Get Bridges, and solve the CAPTCHA. If the website is blocked for you, use Telegram. If both are blocked, as in Russia, ask the support team for a private WebTunnel bridge (see below). -
Copy the bridge line
Copy the whole line, starting with
webtunnel. If the reply has more than one line, add them all, so you have a backup. Asking again right away usually gives you the same bridges. -
Add it to Tor Browser
Go to Settings → Connection, click “Enter bridge addresses you already know”, paste the line(s), click Next, then Connect.
Getting bridges in Russia (2026)
Russia blocks the bridges website and, since March 2026, Telegram too, so the usual sources often won't open. What still works:
-
Connection Assist first
Choose Russia and click “Try a Bridge”. It tries Snowflake, then WebTunnel, then obfs4.
-
obfs4 by request or email
Click Request bridges… in Tor Browser, or email bridges@torproject.org from a Gmail or Riseup address. Both give obfs4, which works on many home connections but is blocked on most mobile networks.
-
A private WebTunnel bridge from support
Email frontdesk@torproject.org with “private bridge ru” in the subject or message. Email is the most dependable way from Russia, because Signal and WhatsApp are often blocked there too. WebTunnel is what the Tor Project recommends on Russian mobile networks.
More, including what to do during mobile internet “whitelists”: Tor in Russia: what works in 2026.
Where to get fresh bridges (official sources only)
If the built-in bridges are blocked, request fresh, unlisted ones. Only use these official channels. Bridges from random websites or group chats can be fake or already blocked.
-
Telegram: @GetBridgesBot
Send
/obfs4or/webtunnel. This is often the best option where the bridges website is blocked, as in Iran. In Russia, Telegram itself is blocked (see Russia). -
The official bridges site
Visit bridges.torproject.org. “Just give me bridges!” gives you obfs4; choose WebTunnel under “Advanced Options”.
-
Inside Tor Browser (desktop)
In Settings → Connection, click Request bridges… and solve the CAPTCHA. This gives obfs4 bridges.
-
Email
Email bridges@torproject.org from a Gmail or Riseup address (other providers aren't accepted). You'll get obfs4 bridges in the reply.
-
The Tor Project's support team
If nothing else works, the support team can send you private bridges that aren't handed out publicly. Message @TorProjectSupportBot on Telegram (English, Russian, and Farsi), write on Signal (+1 778 743 1312) or WhatsApp (+44 7421 000612), or email frontdesk@torproject.org. From Russia, email works best (Signal and WhatsApp are often blocked there); include “private bridge ru”. The team replies Monday to Thursday. See all official support channels.
To use a bridge you received, go to Settings → Connection, click “Enter bridge addresses you already know”, paste the line(s), click Next, then Connect. On Android, use Config Bridge → “Provide a Bridge I know”.
Bridges still not working? Try this
-
Switch bridge type, not just bridges
If obfs4 fails, a new obfs4 bridge usually fails too. Move on to Snowflake or WebTunnel, since they disguise Tor in a completely different way.
-
Get fresh bridges
Censors find and block bridges all the time, so one that worked last week may be dead today. Request new ones from an official source above.
-
Try a different network
Some mobile carriers block bridge types that still work on home Wi-Fi, or the other way round. If you can, test the same bridge on another connection.
-
Rule out the usual suspects
A wrong system clock, an antivirus or firewall blocking Tor, or an outdated Tor Browser can all look like a blocked network. Our Tor not connecting guide walks through each one.
-
Slow with a bridge?
That's normal: bridges are often slower than regular entry relays, and their disguise adds some delay. If your network doesn't actually block Tor, turn the bridge off. (More: why is Tor so slow?)
The bottom line
Bridges are the go-to fix when Tor is blocked. Let Connection Assist try first. Otherwise, start with the built-in obfs4 and move to Snowflake. In heavy censorship, a WebTunnel bridge (from @GetBridgesBot or the Tor Project's support team) is often what gets you through. Stick to official sources, and only use a bridge if you actually need one.
Frequently asked questions
Which Tor bridge should I use first?
On most networks, start with the built-in obfs4. If you're in a heavily censored country such as Russia, Iran, or China, let Connection Assist pick a bridge first, then try Snowflake or a WebTunnel bridge. Use meek only as a last resort, because it's usually slow.
What is a WebTunnel bridge and how do I get one?
WebTunnel makes Tor traffic look like an ordinary visit to an HTTPS
website, which helps where obfs4 is blocked. It isn't built in. Send
/webtunnel to @GetBridgesBot on
Telegram, or choose webtunnel on
bridges.torproject.org.
In Russia, where both are blocked, ask the Tor Project's support
team for a private one. Then, in Settings → Connection, click “Enter bridge addresses you already know” and paste the line.
Do I always need a bridge?
No. You only need a bridge if Tor is blocked on your network. If the Tor Browser connects fine without one, you don't need a bridge, and using one unnecessarily just makes your connection slower.
Are Tor bridges safe?
Yes. Bridges are an official feature built into the Tor Browser. They only change how you enter the Tor network; your traffic is still protected by Tor's normal layered encryption. Just get bridges only from official sources: Tor Browser itself, bridges.torproject.org, @GetBridgesBot, or the Tor Project's support team. (More in is Tor safe?)
Why did my bridge stop working?
Censors actively hunt for bridges and block them, so a bridge that worked last week may be blocked today. Get a fresh one from an official source, or switch to a different bridge type. WebTunnel and Snowflake often keep working where obfs4 has been blocked.
Sources
We base this guide on official Tor Project documentation and independent sources. Links checked November 14, 2026.
- Unblocking Tor (bridge types) — Tor Project Support
- Getting bridges — Tor Project Support
- Using bridges — Tor Project Support
- Connecting to Tor from censored regions — Tor Project Support
- Hiding in plain sight: Introducing WebTunnel (Mar 12, 2024) — Tor Project Blog
- New Release: Tor Browser 14.5 (Connection Assist on Android) — Tor Project Blog
- Staying ahead of censors in 2025 (Dec 3, 2025) — Tor Project Blog
- Russia blocked Telegram (2026) — OONI Explorer
- Tor Project User Support report, December 2025 — Tor Project Forum
- Tor user support channels — Tor Project Support
- New Release: Tor Browser 16.0 — Tor Project Blog
Update history
Significant changes to this guide, newest first. Spotted a mistake? Tell us.
- Updated the steps for Tor Browser 16, which renamed the bridge settings.
- Added a section on getting bridges in Russia.
- Corrected two points: a bridge replaces your first relay instead of adding one, and it makes Tor harder to detect rather than invisible. Added the list of sources.
- Rewrote the guide for Tor Browser 15: Connection Assist, the new bridge buttons, WebTunnel bridges and the official ways to get bridges.
- First published.