Skip to content
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time
Apr 17, 2021
Jan 13, 2019


TorBox is an easy to use, anonymizing router based on a Raspberry Pi. TorBox creates a separate WiFi that routes the encrypted network data over the Tor network. The type of client (desktop, laptop, tablet, mobile, etc.) and operating system on the client do not matter.

For more information, visit the TorBox website
. TorBox Image (about 1.2 GB) : v.0.4.0 (10.04.2021)SHA-256 values
TorBox Menu only : v.0.4.0 (10.04.2021)SHA-256 values

What’s it all about?


Use it at your own risk!

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. Malware, Cookies, Java, Flash, Javascript and more will most certainly compromise your anonymity. Even the people from the Tor Project themselves state 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, if your well-being depends on your anonymity.It is advisable to use Tails (read here, here and here why) in such a situation. Here are additional browser add-ons to improve anonymity, security and/or usability.

Quick Installation Guide

  1. Download the latest TorBox image file and verify the integrity of the downloaded file.
  2. Transfer the downloaded image file on an SD Card; for example, with Etcher. TorBox needs at least a 4 GB SD Card, but 8 GB is recommended.
  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 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.
  4. After 2-3 minutes, when the green LED stops to flicker, connect your client to the new WiFi “TorBox040” (password: CHANGE-IT). Then use an SSH client to access (username: torbox / password: CHANGE-IT). Now, you should see the TorBox main menu. Choose the preferred connection setup, and change the default passwords as soon as possible (the associated entries are placed in the configuration sub-menu). For a connection via cable, see here.

A Raspberry Pi 3 (Model B / Model B+) or a Raspberry Pi 4 Model B is recommended. However, we offer also installation script for other systems, which might run on other hardware platforms.

Do you have additional questions? Check out our Documentation, our FAQ on the TorBox website or contact us.

Start-up instructions


  • TorBox routes all your network data through the Tor network. At the same time, TorBox acts as an external firewall and prevents IP leakage. If wanted, all HTTP plain traffic can be blocked additionally.
  • With the SSH-accessible menu, TorBox provides a user-friendly interface.
  • TorBox supports Internet access via cable (Ethernet), WiFi, tethering devices, cellular links, USB dongles (wlan1/eth1/ppp0/usb0), and VPN connections (tun0).
  • Clients can connect TorBox via WiFi (in most cases, an additional USB WiFi adapter is necessary) and cable (simultaneously; see here).
  • It easily overcomes captive portals and offers, if necessary, measures against “disconnect when idle features” (sometimes seen with WiFis in airports, hotels, coffee houses).
  • TorBox supports OBFS4, Meek-Azure and Snowflake bridges, which help overcome censorship (with an easy to use interface).
  • If you have a public IP address, 24/7 Internet connectivity over a long time, and a bandwidth of at least 1 Mbps, TorBox can provide a bridge relay, easily configurable via a user-friendly interface to allow censored users access to the open Internet.
  • It provides SOCKS v5 proxy functionality on ports 9050 (standard) and 9052 (with destination address stream isolation).
  • It allows easy access to .onion websites without client configuration (Chrome) or via SOCKS v5 proxy (Firefox).

Alternative installation method with the TorBox installation script

Alternatively, you can download the latest version of Raspberry Pi OS Lite, ensure stable Internet connectivity, localize your installation with raspi-config (optional), download and execute our installation script:

chmod a+x

We also offer installation scripts for other systems, which might run on other hardware platforms. However, TorBox’s implementation on other systems and hardware is "experimental" because we do not have the resources to check all details on all different installations. You can help us with reporting errors back to us.

Building from scratch

All you need to run TorBox on your Raspberry Pi is the image file. However, if you want to build it from scratch, whether you like to implement it to an existing system, to another hardware, respectively another operating system, or you don’t trust an image file, which you didn’t bundle of your own, then check out our detailed manual for a Raspberry Pi with Raspberry Pi OS Lite.

I want to help...

GREAT! There is a lot to improve and fix (security of the entire system, graphical menu, cool logos ...). We are searching for people who want to help, and we need especially your feedback to improve the system. You can also donate to the Tor Project -- without them, TorBox would not exist.