Installation

There are three different ways, how to install TorBox on your Raspberry Pi:

  1. By downloading the latest TorBox image file (recommended!
  2. With our installation script
  3. From scratch

• • •

1. Installation of our image file

This is the recommended and probably easiest way to install TorBox:

  1. Download the latest TorBox image file (TorBox v.0.3.1 based on Raspberry Pi OS “Buster” Lite with the Linux Kernel 4.19.118 and Tor version 0.4.2.7; about 675 Mb) 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 at least 8 GB are recommended.
  3. Put the SD Card into your Raspberry Pi 3 (Model B / Model B+) or Raspberry Pi 4 Model B , 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 “TorBox031” (password: CHANGE-IT). Then use an SSH-client to access 192.168.42.1 (username: pi / 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).

• • •

2. Installation by running the installation script

This is probably the most efficient way to install TorBox. In addition, with that method, you will have the latest version of the base system and the TorBox menu and don’t have to wait for the next release of the image file. Be warned: Either it works, or chaos is perfect. 😬 As now, it has been working quite reliable. 😌

  1. Download the latest version of the Raspberry Pi OS Lite (about 435 MB)
  2. Transfer the downloaded aspberry Pi OS Lite image on an SD Card; for example, with Etcher. TorBox needs at least a 4 GB SD Card, but at least 8 GB are recommended.
  3. Log into your newly set up system and, if needed, configure it with “sudo raspi-config”.
    Important
    – You need to have a stable Internet connection. This is necessary to ensure that the
    installation script runs smoothly.
  4. Download and run the script:
    cd
    wget https://raw.githubusercontent.com/radio24/TorBox/master/install/run_install.sh 
    chmod a+x run_install.sh 
    ./run_install.sh
    
  5. Restart the system; connect your client to the new WiFi “TorBox031” (password: CHANGE-IT). Then use an SSH-client to access 192.168.42.1 (username: pi / 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).

• • •

3. Installation from Scratch

This is probably the safest, however, also the most conplicated and time-consuming way to install TorBox. Technically, it doesn’t differ from the installation with the installation script — the only difference is that you write the necessary configuration files by hand.
Form more information, go to our detailed manual.