TorBox is an easy to use, anonymizing router based on Raspberry Pi.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
etc Add the etc folder Jan 23, 2019
run Check Log status directly, not via Feb 9, 2019
text run- and text-files Jan 24, 2019
.gitignore Create .gitignore Jan 23, 2019
LICENSE Initial commit Jan 13, 2019 URL fix Feb 10, 2019
change_ssid Create change_ssid Jan 22, 2019
change_ssid_pw Create change_ssid_pw Jan 22, 2019
erase_logs Update erase_logs Jan 23, 2019
menu Change logging behaviour Feb 4, 2019
menu-a Minor fix in "Erase all log files" Feb 9, 2019
new_ident Create new_ident Jan 22, 2019
save_connection Create save_connection Jan 22, 2019
set_bridged_mode Create set_bridged_mode Jan 22, 2019
set_captive Create set_captive Jan 22, 2019
set_interfaces Create set_interfaces Jan 23, 2019
update Update update Jan 24, 2019


TorBox is an easy to use, anonymizing router based on 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 don’t matter.

For more information visit the TorBox website
TorBox Image (900 MB) : v.023 (09.02.2019)
TorBox Menu only : v.023 (09.02.2019)


TorBox is in an “alpha test phase”. Use it at your own risk!

TorBox is ideal for providing additional protection for the entire data stream up to the Tor network and for 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. In such a situation it is advisable to use Tails (read here, here and here why).

Quick Installation Guide

  1. Download the latest TorBox image file.
  2. Transfer the downloaded image file on an SD Card; for example with Etcher. TorBox needs at least a 4 Gbyte SD Card, but 8 Gbyte is recommended.
  3. Put the SD Card into your Raspberry Pi, link it with an Internet router using an Ethernet cable or place a USB WiFi adapter in one of the USB ports to use an already existing WiFi. Afterward, 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 “TorBox023” (password: CHANGE-IT). Then use an SSH-client to access (username: pi / password: CHANGE-IT). Now, you should see the TorBox menu. Choose the preferred connection setup and change the default passwords as soon as possible (the associated entries are placed in the advanced menu).

Raspberry Pi 3 (Model B or better a Model B+) is recommended because it is the most powerful version of the Raspberry Pi family and comes with an integrated WiFi chip.

Do you have additional questions? Check out our FAQ on the TorBox website.

Building From Scratch

All that you need to run TorBox on your Raspberry Pi is the image file. However, if you like to build it from scratch on your own, 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. It helps you to build a TorBox from scratch.