# How to use WebTunnel?

**URL:** https://forum.torproject.org/t/how-to-use-webtunnel/11246
**Category:** Core Tor
**Created:** [January 22, 2024, 10:57am UTC](https://forum.torproject.org/t/how-to-use-webtunnel/11246 "2024-01-22T10:57:53Z")
**Posts on this page:** 10
**Page:** 1

<div class="post-metadata">

### Author: ![hack3rcon](https://forum.torproject.org/user_avatar/forum.torproject.org/hack3rcon/32/3606_2.png) [@hack3rcon](https://forum.torproject.org/u/hack3rcon)
#### Post date: [January 22, 2024, 10:57am UTC](https://forum.torproject.org/t/how-to-use-webtunnel/11246/1 "2024-01-22T10:57:53Z")

</div>

Hello,  
I added the following lines to the `torrc` file:

```auto
UseBridges 1
ClientTransportPlugin webtunnel exec ./client
Bridge webtunnel XXX:443 XXX url=https://XXX ver=0.0.1
SocksPort auto
Log info
```

But I got the following error:

```auto
Jan 21 05:29:41.000 [notice] Bootstrapped 0% (starting): Starting
Jan 21 05:29:42.000 [notice] Starting with guard context "bridges"
Jan 21 05:29:42.000 [notice] Delaying directory fetches: No running bridges
Jan 21 05:29:42.000 [warn] Pluggable Transport process terminated with status code 256
```

Why?

Thank you.

---

<div class="post-metadata">

### Author: ![abysshint](https://forum.torproject.org/user_avatar/forum.torproject.org/abysshint/32/3472_2.png) [@abysshint](https://forum.torproject.org/u/abysshint)
#### Post date: [January 23, 2024, 12:00pm UTC](https://forum.torproject.org/t/how-to-use-webtunnel/11246/2 "2024-01-23T12:00:26Z")

</div>

Specify the **correct path** to the Pluggable Transport file to be used **after the exec** parameter.  
For example:

```auto
exec c:\tor\pluggable_transports\webtunnel-client.exe # Windows
exec /home/user/tor/pluggable_transports/webtunnel-client # Llinux

```

Take the files for Pluggable Transports from the [Tor Expert Bundle](https://www.torproject.org/download/tor/)

---

<div class="post-metadata">

### Author: ![hack3rcon](https://forum.torproject.org/user_avatar/forum.torproject.org/hack3rcon/32/3606_2.png) [@hack3rcon](https://forum.torproject.org/u/hack3rcon)
#### Post date: [January 24, 2024, 10:37am UTC](https://forum.torproject.org/t/how-to-use-webtunnel/11246/3 "2024-01-24T10:37:53Z")

</div>

Hello,  
Thank you so much for your reply.

> The tor expert bundle contains the tor and pluggable transports binaries, bridge strings, and geoip data used in Tor Browser.

Is this just for Tor Browser? I am using the Tor package on Debian.

---

<div class="post-metadata">

### Author: ![abysshint](https://forum.torproject.org/user_avatar/forum.torproject.org/abysshint/32/3472_2.png) [@abysshint](https://forum.torproject.org/u/abysshint)
#### Post date: [January 24, 2024, 12:14pm UTC](https://forum.torproject.org/t/how-to-use-webtunnel/11246/4 "2024-01-24T12:14:16Z")

</div>

> [@hack3rcon](#):
>
> Is this just for Tor Browser?

Not necessary. Tor and Pluggable Transports from the Tor Expert Bundle can be used without the Tor Browser.

---

<div class="post-metadata">

### Author: ![hack3rcon](https://forum.torproject.org/user_avatar/forum.torproject.org/hack3rcon/32/3606_2.png) [@hack3rcon](https://forum.torproject.org/u/hack3rcon)
#### Post date: [January 27, 2024, 11:01am UTC](https://forum.torproject.org/t/how-to-use-webtunnel/11246/5 "2024-01-27T11:01:49Z")

</div>

Hello,  
Thanks again.  
Can I install it with `apt install` command?

---

<div class="post-metadata">

### Author: ![abysshint](https://forum.torproject.org/user_avatar/forum.torproject.org/abysshint/32/3472_2.png) [@abysshint](https://forum.torproject.org/u/abysshint)
#### Post date: [January 27, 2024, 3:45pm UTC](https://forum.torproject.org/t/how-to-use-webtunnel/11246/6 "2024-01-27T15:45:44Z")

</div>

> [@hack3rcon](#):
>
> Can I install it with `apt install` command?

No. The **WebTunnel** Pluggable Transport **is not available** in the Debian repositories. However, you can install Go-lang and build it from source yourself:

```auto
$ sudo apt install golang

$ git clone https://gitlab.torproject.org/tpo/anti-censorship/pluggable-transports/webtunnel

$ cd webtunnel/main/client
$ go build

$ sudo cp client /usr/bin/webtunnel

```

---

<div class="post-metadata">

### Author: ![hack3rcon](https://forum.torproject.org/user_avatar/forum.torproject.org/hack3rcon/32/3606_2.png) [@hack3rcon](https://forum.torproject.org/u/hack3rcon)
#### Post date: [January 29, 2024, 11:35am UTC](https://forum.torproject.org/t/how-to-use-webtunnel/11246/7 "2024-01-29T11:35:08Z")

</div>

Hello,  
Thank you so much.  
After, can I use the following line in the `torrc` file:

```auto
Bridge webtunnel XXX:443 XXX url=https://XXX ver=0.0.1
```

---

<div class="post-metadata">

### Author: ![abysshint](https://forum.torproject.org/user_avatar/forum.torproject.org/abysshint/32/3472_2.png) [@abysshint](https://forum.torproject.org/u/abysshint)
#### Post date: [January 29, 2024, 12:01pm UTC](https://forum.torproject.org/t/how-to-use-webtunnel/11246/8 "2024-01-29T12:01:49Z")

</div>

Yes, the main thing is not to forget to add **UseBridges** and **ClientTransportPlugin** with the **correct path** to the Webtunnel client file. Example:

```auto
UseBridges 1
ClientTransportPlugin webtunnel exec /usr/bin/webtunnel
Bridge webtunnel <IP>:<PORT> <FINGERPRINT> url=<URL> ver=0.0.1

```

---

<div class="post-metadata">

### Author: ![hack3rcon](https://forum.torproject.org/user_avatar/forum.torproject.org/hack3rcon/32/3606_2.png) [@hack3rcon](https://forum.torproject.org/u/hack3rcon)
#### Post date: [January 31, 2024, 11:04am UTC](https://forum.torproject.org/t/how-to-use-webtunnel/11246/9 "2024-01-31T11:04:43Z")

</div>

Hello,  
Thanks again.

1. I added the bridge and restarted Tor daemon, but the result is:

```auto
...
Jan 31 02:03:22.275 [notice] Read configuration file "/usr/share/tor/tor-service-defaults-torrc".
Jan 31 02:03:22.275 [notice] Read configuration file "/etc/tor/torrc".
Jan 31 02:03:22.277 [notice] Opening Socks listener on 127.0.0.1:9050
Jan 31 02:03:22.277 [notice] Opened Socks listener connection (ready) on 127.0.0.1:9050
Jan 31 02:03:22.000 [notice] Parsing GEOIP IPv4 file /usr/share/tor/geoip.
Jan 31 02:03:22.000 [notice] Parsing GEOIP IPv6 file /usr/share/tor/geoip6.
Jan 31 02:03:22.000 [notice] Bootstrapped 0% (starting): Starting
Jan 31 02:03:22.000 [notice] Starting with guard context "bridges"
Jan 31 02:03:22.000 [notice] Delaying directory fetches: No running bridges
Jan 31 02:03:22.000 [notice] Signaled readiness to systemd
Jan 31 02:03:23.000 [notice] Opening Socks listener on /run/tor/socks
Jan 31 02:03:23.000 [notice] Opened Socks listener connection (ready) on /run/tor/socks
Jan 31 02:03:23.000 [notice] Opening Control listener on /run/tor/control
Jan 31 02:03:23.000 [notice] Opened Control listener connection (ready) on /run/tor/control
Jan 31 02:03:43.000 [notice] Application request when we haven't used client functionality lately. Optimistically trying known bridges again.
```

Why?

1. When I add a new bridge, do I have to restart the Tor or is reloading enough?

---

<div class="post-metadata">

### Author: ![system](https://forum.torproject.org/uploads/default/original/2X/d/d3424bed34f4ec18b2e99178c2801ba6dfb655d6.png) [@system](https://forum.torproject.org/u/system)
#### Post date: [February 5, 2024, 4:40pm UTC](https://forum.torproject.org/t/how-to-use-webtunnel/11246/10 "2024-02-05T16:40:24Z")

</div>

This topic was automatically closed 24 hours after the last reply. New replies are no longer allowed.
