Installation

There are three different ways, how to install TorBox. The default ist to install TorBox on a Raspberry Pi 3 (Model B / Model B+) or a Raspberry Pi 4 Model B running Raspberry Pi OS Lite. However, there is another installation script that installs TorBox on Ubuntu Server 20.04 LTS (32/64 bit). and therefore, might run on other hardware platforms (this script is currently in an experimental state).

• • •

Using our image file on a Raspberry Pi (recommended!)

This is the recommended and probably easiest way to install TorBox on a Raspberry Pi:

  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).

• • •

Installation by running our installation script on a Raspberry Pi with Raspberry Pi OS Lite

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 Raspberry 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).

• • •

Installation from scratch on a Raspberry Pi with Raspberry Pi OS Lite

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.

• • •

EXPERIMENTAL: TorBox on Ubuntu Server 20.04 LTS (32/64 bit) and other hardware platforms by running our installation script

The idea of that installation script is to provide TorBox for other hardware platforms. It also works on a Raspberry Pi (and is tested on it), but we recommend to use Raspberry Pi OS Lite on a Raspberry Pi.

  1. Download the latest version of the Ubuntu Server 20.04 LTS for your specific hardware.
  2. Install Ubuntu Server 20.04 LTS.
  3. Log into your newly set up system.
    Important
    – After a freshly installed system, you might wait one or two minutes until you can log
    in with ubuntu (password: ubuntu).
    – You need to have a stable internet connection.
  4. Download and run the script:
    cd wget https://raw.githubusercontent.com/radio24/TorBox/master/install/run_install_on_ubuntu.sh
    chmod a+x run_install_on_ubuntu.sh
    ./run_install_on_ubuntu.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: 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).

• • •

Installation from scratch on Ubuntu Server 20.04 LTS (32/64 bit)

Form more information, go to our detailed manual.