Preview: These docs are available early so you can start using them now. Some pages may still be incomplete, outdated, or change as WebLibre develops.

Tor Integration

WebLibre includes a built-in Tor proxy, so you do not need a separate Tor app just to get started.

Tor is one of WebLibre’s built-in connection options and appears alongside your proxy profiles. You can use it in several ways:

  • for all regular tabs

  • only for selected containers

  • for private tabs

That makes it practical to keep everyday browsing fast while sending more sensitive browsing through Tor.

What Tor Does

Tor sends your connection through multiple relays before it reaches a website.

Your device -> Tor relay -> Tor relay -> Tor relay -> website

This helps hide your IP address from the website you visit. It also makes it harder for your network provider or people on the same Wi-Fi network to see exactly which sites you are opening.

Tor helps most when you want to separate your browsing from your home, work, or mobile network identity.

What Tor Does Not Do

Tor is useful, but it is not magic.

  • If you sign in to your normal accounts, those services still know it is you.

  • Websites can still try to identify you using browser fingerprinting.

  • Some websites block or challenge Tor exits.

  • Tor does not make unsafe downloads or unsafe websites safe.

For better privacy, combine Tor with WebLibre’s Fingerprint Protection and browse without logging into personal accounts when possible.

Start and Stop Tor

Tor lives in the Connections section of the browser menu, together with your proxy profiles.

  1. Open the browser menu

  2. Expand the Connections section

  3. Use the toggle on the Tor™ Proxy row to start or stop Tor

The section also shows how many connections are currently active, and Manage Connections opens the full connection list.

To open the Tor settings screen, tap the edit button on the Tor row, or open Tor from Settings > Proxy > Proxy Connections, where Tor is listed alongside your proxy profiles. The main switch on that screen is the Tor™ Service toggle.

While Tor is connecting, WebLibre shows a progress bar. The first connection may take a little longer than later reconnects.

Choose How Tabs Use Tor

Which tabs go through Tor is controlled by the shared proxy routing settings in Settings > Proxy > Proxy Routing. Tor is one of the connections you can select there.

Container-Based Routing

With Container-Based Routing, only tabs in containers that have a proxy assigned are routed. To send a container through Tor, assign Tor as that container’s Proxy Connection (see below).

This is the most flexible option if you want a mix of normal browsing and Tor browsing in one app.

Example:

  • your everyday container uses a normal connection

  • a research container with Cookie Isolation uses Tor

  • a shopping container uses a normal connection

If you do not see container options in the app, enable Show Container UI in browsing settings first.

Global Routing

With Global Routing, all regular tabs go through the proxy you select under Proxy for global routing — choose Tor there to send everything through Tor.

This is simpler, but usually slower than routing only selected containers. Individual containers can still opt out with Bypass Global Proxy, which is useful for sites that block Tor.

Private Tabs

Under Private Tabs, you can choose a separate proxy for private tabs — including Tor.

Private tabs and Tor are different features:

  • private tabs mainly limit what is kept locally on your device

  • Tor changes how your traffic leaves the app

Using both together can be useful, but one does not replace the other.

Use Tor With Containers

To route only one container through Tor:

  1. Open your containers

  2. Create a new container and turn on Cookie Isolation, or open one that already has Cookie Isolation

  3. Under Privacy & Security, tap Proxy Connection and choose Tor

  4. Keep Container-Based Routing selected in Settings > Proxy > Proxy Routing

If you select a container assigned to Tor while Tor is not already running, WebLibre can prompt you to enable it.

Onion Sites

WebLibre handles .onion addresses in a Tor-friendly way:

  • Typing an onion address without http:// or https:// opens it over http://, matching how many onion services work.

  • WebLibre does not force HTTPS upgrades for .onion sites, which improves compatibility with onion services.

  • If you explicitly type an https://…​onion address, WebLibre keeps HTTPS.

Onion connections are already encrypted end to end inside the Tor network, so plain http:// onion addresses do not carry the same risk as plain HTTP on the open web.

Connection Options

The Circumvention section is for places or networks where Tor is harder to connect.

Auto Configure Transport

Auto Configure Transport lets WebLibre automatically choose a transport when needed.

If you know your network blocks normal Tor connections, you can also enable I’m sure I cannot connect without a bridge.

This is the safest starting point if Tor will not connect and you are not sure which option to pick.

Manual Options

If you turn off Auto Configure Transport, WebLibre shows manual choices:

  • Direct Connection - best when Tor is not blocked

  • obfs4 - for lighter censorship and better bandwidth

  • Snowflake - for heavier censorship

You can also enable Fetch fresh Bridges before connecting when using bridge-based options.

These options help Tor connect. They do not guarantee that every network or country restriction can be bypassed.

Country Restrictions

You can optionally set Entry Country and Exit Country.

  • Entry Country chooses where your traffic enters the Tor network.

  • Exit Country chooses where websites see your traffic coming from.

Leaving both on Automatic is usually the best choice for reliability.

Restricting countries reduces the number of relays Tor can use, which can make connections slower or less reliable.

Also, choosing an exit country does not guarantee access to region-locked services, and many such services block Tor traffic altogether.

Using the Country Picker

When you change Entry Country or Exit Country, WebLibre opens a searchable picker.

The picker includes:

  • Automatic if you do not want to force a country

  • country names

  • country flags where available

Search the picker when you already know the country you want. Leave it on Automatic if reliability matters more than location control.

Request New Identity

When Tor is connected, you can tap Request New Identity.

This asks Tor for a new circuit, which may give you a different exit IP address.

Use it when:

  • a site is blocking your current Tor exit

  • you want to reduce linkability between one Tor session and the next

It is helpful, but it is not a full reset of every website session by itself.

What to Expect

Tor is usually slower than a normal connection.

You may notice:

  • slower page loads

  • more CAPTCHAs or site challenges

  • video streaming that buffers more often

  • large downloads taking much longer

That tradeoff is normal. For most people, Tor works best for browsing that needs extra privacy, not for everything all the time.

Practical Tips

  • Prefer HTTPS websites whenever possible.

  • Avoid signing in to personal accounts if you want anonymity from that service.

  • Use Container-Based Routing if only some browsing needs Tor.

  • Combine Tor with Fingerprint Protection for better privacy.

  • If Tor will not connect, try Auto Configure Transport first.

  • If a site breaks on Tor, try Request New Identity, give that site’s container Bypass Global Proxy, or open the site outside Tor.