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.

Edited by Sam R. · Published · Updated

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.

  1. Try to connect normally

    If it fails, you'll see a message like “Tor Browser could not connect to Tor.”

  2. Pick your location

    Under “Unblock the Internet in”, leave it on Automatic or choose your country from the list.

  3. 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:

  1. 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#connection in the address bar.

  2. 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”.

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

  4. 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:

Tor bridge types compared: how each one disguises Tor, whether it's built in, and when to use it.
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:

  1. 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).

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

  3. 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 /obfs4 or /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.

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.