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 the help of our install script (EXPERIMENTAL!)
  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.0based on Raspbian “Buster” Lite with the Linux Kernel 4.19.75 and Tor version 0.4.2.5; about 1 GB) 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 “TorBox030” (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 with running the install script (EXPERIMENTAL!)

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. However, currently, the script now has configuration options (wee will work on that during this year). Either it works, or chaos is perfect. 😬 As now, it has been working quite reliable. 😌

  1. Download the latest version of Raspbian Lite (about 435 MB)
  2. Transfer the downloaded Raspian 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 configure it with “sudo raspi-config”. Besides the localization of your system (not needed, but convenient), you need to configure 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 “TorBox030” (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 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.

  1. Download the latest version of Raspbian Lite (about 435 MB)
  2. Transfer the downloaded Raspian 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 configure it with “sudo raspi-config”. Besides the localization of your system (not needed, but convenient), you should configure a stable internet connection.
  4. Go to our detailed manual and start to build a TorBox from scratch.