Sub-menu: Configuration

The Configuration sub-menu of TorBox v.0.3.0
The Configuration sub-menu of TorBox v.0.3.0

The primary purpose of this sub-menu is to offer a simple way to configure your TorBox. In this sub-menu, you also find all the necessary entries to change the default passwords. You should do that as soon as possible — check the red colored menu entries below.

In the following, we look at all menu entries one by one:

  • Menu entry 1: Change admin (user pi) password: That’s the first thing you should do!

  • Menu entry 2: Change the name of TorBox’s WLAN: Depending on your environment, it could be a good idea to camouflage your wireless network with an appropriate name.

  • Menu entry 3: Change the password of TorBox’s WLAN: That’s the second thing you should do! A reboot is required to take effect.

    Important: Only letters (upper and lower case) and numbers are allowed. The length must be between 8 and 63 characters

  • Menu entry 4: Set TorBox’s WLAN regulatory domain for the 5 GHz band: By default, TorBox WLAN regulatory domain is set to the United States, which works in most cases. Depending on the location, however, it may be necessary to adjust the WLAN regulatory domain in order to use all bands, channels and frequencies and not get in trouble.

  • Menu entry 5: Change TorBox’s WLAN from the xx GHz to the xx GHz band: This menu entry changes the TorBox’s WLAN — the one, which is connected by the SSH client — from 2,5 GHz to 5 GHz or back. If you are in an area with many devices transmitting on 2.5 GHz, a change on the 5 GHz band could solve some problems and provide a higher throughput. This is only supported by a  Raspberry Pi 3 Model B+ or a Raspberry Pi 4 Model B.
Graphical representation of overlapping 20 MHz channels within the 2.4 GHz band
Graphical representation of overlapping 20 MHz channels within the 2.4 GHz band (from Wikipedia, “List of WLAN channels”).

  • Menu entry 6: Change TorBox’s WLAN channel and the MHz: This menu entry changes the channel and the frequency of TorBox’s WLAN. If you are in an area with many devices communicating on the same channel you’re using for TorBox’s WLAN, changing channels can solve some problems and increase throughput. It is also true that higher frequencies are associated with a higher throughput. However, this also means that more power is required and thus a reliable power supply. Frequencies above 20 MHz are only supported by a  Raspberry Pi 3 Model B+ or a Raspberry Pi 4 Model B.

    Important: 40 MHz is only activated if there is no overlap with other devices. For this purpose hostapd performs a background scan. This can also be checked with the following command: hostapd -dd /etc/hostapd/hostapd.conf

  • Menu entry 7: Hide / unhide TorBox’s WLAN: If you choose “hide”, then TorBox sends empty SSID in beacons and ignore probe request frames that do not specify full SSID. In other words: to connect with your wireless network, the full name of that network has to be known. “Unhide” will reverse this behavior.

  • Menu entry 8: Change the password of your Tor control port: The control port is used for controlling Tor, usually through other software. To change that password is usually not necessary. If you, nevertheless, change the password, Tor restarts automatically, which interrupts all connections through TorBox until Tor is running again. The progress can be monitored with entry 3 in the main menu.

  • Menu entry 9: Changing the extent of logging: By default, TorBox reduces logging to a minimum. However, the protocol function for Tor remains activated so that the correct function of Tor can be determined. Tor ensures that no sensitive information is leaked into the log files. For detailed troubleshooting, the log function can be set to “High”, which effectively means that the normal log function of the operating system is activated.
A portion of Tor's log file (/var/log/tor/notices.log) when logging is set to "low".
A portion of Tor’s log file (/var/log/tor/notices.log) when logging is set to “low”.

  • Menu entry 10: Erase all log files: It does what it says.

  • Menu entry 11: Support for Adafruit’s PiTFT displays: A nice way to display the real-time statistics (main menu entry 1) of TorBox is to combine a Raspberry Pi with a PiTFT 3.5″ resistive touch 320×480 from Adafruit (for more information see here). With this menu entry the necessary drivers are installed. TorBox has to be connected to the internet and a reboot is required to take effect. Supported are following Adafruit’s PiTFT displays: PiTFT 3.5″ resistive touch 320×480, PiTFT 2.8“ capacitive touch 240×320, PiTFT 2.4″, 2.8″ or 3.2″ resistive 240×320, PiTFT 2.2″ no touch 240×320, Braincraft 1.54″ display 240×240.

  1. TorBox’s menus and dialog boxes have only been adapted for the PiTFT 3.5 (320×480) or any other display, which displays in textual mode at least 25×80 characters.
  2. Adafruit’s TFT screens are widely used and are therefore included in the configuration menu. On request, we are happy to support other widespread small screens for the Raspberry Pi.

• • •

Problems and questions

  • Should I change the default passwords? How can I change my passwords? –> see here.
  • Should I change the name of the wireless network (SSID) of my TorBox? How can I change it? –> see here.
  • Can I hide the name of the wireless network (SSID) of my TorBox? –> see here.
  • Wicd (the network manager) doesn’t show me all wireless networks! It seems that the ones on the 5GHz band are missing. What can I do? –> see here.
  • Wicd (the network manager) tries to connect a wireless network, but it sticks with “Validating authentication”, the program crashes and/or seems to have many bugs. What’s wrong? –> see here.