You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,11 +5,11 @@
5
5
# TorBox
6
6
TorBox is an easy-to-use, anonymising router based on Raspberry Pi, which also runs on Debian, DietPi and Ubuntu-based systems. TorBox can create a separate WiFi that routes the encrypted network data over the Tor network. However, TorBox also supports clients who are connected to a cable. As [TorBox mini](https://www.torbox.ch/?page_id=3544), it can be plugged into an USB socket and be used as a network device which sends all the traffic to the Tor network. [TorBox on a Cloud](https://www.torbox.ch/?page_id=3687) can be used on a cloud combined with an OpenVPN server -- it is literally a private VPN with tor functionality. Locally installed or on a cloud, TorBox also helps to publish data easily and safely through Onion Services. The type of client (desktop, laptop, tablet, mobile, etc.) and the operating system on the client don’t matter. For more information, visit the [TorBox website](https://www.torbox.ch).
**TorBox Menu only**: [v.0.5.5 (01.12.2025)](https://www.torbox.ch/data/torbox055-20251201.zip) – [SHA-256 values](https://www.torbox.ch/?page_id=1128)
11
11
12
-
Or download the image from [our TorBox on the cloud test installation](http://x63xkeiw3cgczc6lcwf62aoe35rp6hfcz3mympmuha7xhj63qdf3ngid.onion/).
12
+
Alternatively, you can download the image from [our TorBox cloud test installation](http://x63xkeiw3cgczc6lcwf62aoe35rp6hfcz3mympmuha7xhj63qdf3ngid.onion/).
13
13
14
14
15
15
@@ -19,18 +19,18 @@ Or download the image from [our TorBox on the cloud test installation](http://x6
19
19
TorBox is ideal for providing additional protection for the entire data stream and overcoming censorship. However, **anonymity is hard to get – solely using Tor doesn’t guarantee it**. [Traffic correlation analysis](https://www.torbox.ch/?p=3634), malware, cookies, Java, Flash, Javascript and more will most certainly compromise your anonymity. Even the people from the [Tor Project themselves state](https://2019.www.torproject.org/about/overview.html.en#stayinganonymous) that “Tor can’t solve all anonymity problems. It focuses only on protecting the transport of data.” Therefore, **it is strongly advised not to use TorBox alone, should your well-being depend on your anonymity**. In such a situation, it may be better to use [Tails](https://tails.net/). Please, [read in the FAQ more about tracking and fingerprinting in web browsers](https://www.torbox.ch/?page_id=112#can-tor-protect-me-against-tracking-andor-fingerprinting-in-web-browser-to-guaranty-my-anonymity-accessing-a-website).
20
20
21
21
### Quick Installation Guide
22
-
1.[Download the latest TorBox image file](https://www.torbox.ch/data/torbox-20250720-v054.img.xz) and [verify the integrity of the downloaded file](https://www.torbox.ch/?page_id=1128).
22
+
1.[Download the latest TorBox image file](https://www.torbox.ch/data/torbox-20251201-v055.img.xz) and [verify the integrity of the downloaded file](https://www.torbox.ch/?page_id=1128).
23
23
2. Transfer the downloaded image file on an [SD Card](https://en.wikipedia.org/wiki/Secure_Digital). Because of the significantly better compression rate, we compress the images with [xz](https://en.wikipedia.org/wiki/XZ_Util). By default, [Balena Etcher](https://etcher.balena.io/) and the [Raspberry Pi Imager](https://www.raspberrypi.com/software/) support this kind of compressed image, but sometimes one or the other fails with an error message to flash it correctly on a SD Card. In this case, [you need to decompress the .xz file first](https://www.perplexity.ai/search/how-can-i-decompress-a-xz-file-72DH3Nq1Q5quofx8wu02SQ#0). TorBox needs at least a 16 GB SD Card.
24
24
3. Put the SD Card into your Raspberry Pi, link it with an Internet router using an Ethernet cable, or place an USB WiFi adapter in one of the Raspi's USB ports to use an existing WiFi. Afterwards, start the Raspberry Pi. During the start, the system on the SD card automatically expands over the entire free partition – user interaction, screen, and peripherals are not required yet.
25
-
4. After 2-3 minutes, when the green LED stops to flicker, connect your client to the new WiFi “**TorBox054**” (password: **CHANGE-IT**).
26
-
5. Login to the TorBox by using a [SSH client](https://www.torbox.ch/?page_id=112#how-can-i-access-the-torbox-menu) (**192.168.42.1** on a WiFi client, **192.168.43.1** on a cable client or **192.168.44.1** when connected via VPN or if you use [TorBox mini](https://www.torbox.ch/?page_id=3544) on a [Raspberry Pi Zero 2 W](https://www.raspberrypi.com/products/raspberry-pi-zero-2-w/) as a RNDIS/Ethernet Gadget) or a web browser (http://192.168.42.1 on a WiFi client, http://192.168.43.1 on a cable client or http://192.168.44.1 when connected via VPN; username: **torbox** / password: **CHANGE-IT**).
25
+
4. After 2-3 minutes, when the green LED stops to flicker, connect your client to the new WiFi “**TorBox055**” (password: **CHANGE-IT**).
26
+
5. Login to the TorBox by using a [SSH client](https://www.torbox.ch/?page_id=112#how-can-i-access-the-torbox-menu) (**192.168.42.1** on a WiFi client, **192.168.43.1** on a cable client or **192.168.44.1** when connected via VPN or if you use [TorBox mini](https://www.torbox.ch/?page_id=3544) on a [Raspberry Pi Zero 2 W](https://www.raspberrypi.com/products/raspberry-pi-zero-2-w/) as a RNDIS/Ethernet Gadget) or a web browser (http://192.168.42.1 on a WiFi client, http://192.168.43.1 on a cable client or http://192.168.44.1 when connected via VPN or when using TorBox mini; username: **torbox** / password: **CHANGE-IT**).
27
27
6. After [seeing a welcome screen and answering some initial questions during the first start-up](https://www.torbox.ch/?page_id=2637), you should see the [TorBox Main Menu](https://www.torbox.ch/?page_id=775). Immediately, you should **change the default passwords** (the associated entries are placed in the [configuration sub-menu](https://www.torbox.ch/?page_id=875).
28
28
29
29
At least a **[Raspberry Pi 3 Model B+](https://www.raspberrypi.org/products/raspberry-pi-3-model-b-plus/)**, a **[Raspberry Pi 4 Model B](https://www.raspberrypi.org/products/raspberry-pi-4-model-b/)** or a **[Raspberry Pi 5](https://www.raspberrypi.com/products/raspberry-pi-5/)** is recommended. We also offer [installation script for other systems](https://www.torbox.ch/?page_id=1168), which might run on older (32bit) or other hardware platforms.
30
30
31
31
Do you have additional questions? Check out our [Documentation](https://www.torbox.ch/?page_id=775), our [FAQ on the TorBox website](https://www.torbox.ch/?page_id=112) or [contact us](mailto:anonym@torbox.ch).
* TorBox routes all your network data through the Tor network. At the same time, TorBox acts as an external firewall and prevents IP leakage. It also can block insecure HTTP requests. However, optionally, [TorBox can also exclude domains](https://www.torbox.ch/?page_id=3445) from be routed through the Tor network.
0 commit comments