Sub-menu: Update and Reset

The update and reset sub-menu of TorBox v.0.3.0.
The update and reset sub-menu of TorBox v.0.3.0.

The primary purpose of this sub-menu is to offer a simple way to update and reset your TorBox. It is differently designed than the other sub-menus. The selection has to be made using the space bar, which is executed by pressing “Enter”. The reason is that one or more selections can be made, which are then executed one after the other. In the following, we look at all menu entries one by one:

  • Menu entry 1: Update the base system: This menu entry updates your base system (Raspberry Pi OS), including the kernel. In general, it automatically updates also the firmware and Tor. Usually, you do not have to select menu entries 2 and 3. However, without selecting the menu entry 4, the TorBox menu will not be actualized. The update runs in a screen session, meaning that if you close the SSH client or if you lose your connection to the TorBox, the update process continues until all is done. You can always make a new SSH-connection, leave the menu with ESC and execute screen -x to see the progress of the update.

    Important
Before the update starts, the current version of installed Linux, Tor, and Wicd is displayed.
Before the update starts, the current version of
installed Linux, Tor, and Wicd is displayed.
  1. Before the update starts, the current version of installed Linux, Tor, and Wicd is displayed. Only after another confirmation, the update starts.
  2. According to your Raspberry Pi version, the update procedure can last up to 30 minutes. Do not remove power from your TorBox during the update.
  3. A reboot is highly recommended after an update and necessary to load a new kernel.

  • Menu entry 2: Update the firmware of the Raspberry Pi 4: Does what it says! It is only supported by a Raspberry Pi 4 Model B.

  • Menu entry 3: Update to the newest version of Tor: Usually, you should update the entire base system (menu entry 1), which also updates Tor to the newest version. If something goes wrong, and it does not update to the latest available stable version, then this menu entry gives you an alternative way to install Tor. It fetches the source package from the Tor repository and compiles it on the Raspberry Pi. According to your Raspberry Pi version, the update procedure can last up to 30 minutes. Do not remove power from your TorBox during the update.

    Important
  1. Before the update starts, the current version of installed Linux, Tor, and Wicd is displayed. Additionally, the newly available Tor version number is being displayed. Only after another confirmation, the update starts.
  2. According to your Raspberry Pi version, the update procedure can last up to 30 minutes. Do not remove power from your TorBox during the update.

  • Menu entry 4: Update to the newest stable version of TorBox: This menu entry fetches and installs the latest stable version of the TorBox menu from its GitHub repository. However, this menu entry will not update / overwrite / reset TorBox’s configuration files — usually, this is not necessary for minor updates. Check our blog entries for major updates, and if necessary, update / change TorBox’s configuration files.

  • Menu entry 5: Erase all log files: Does what it says!

  • Menu entry 6: Update / Reset TorBox’s configuration files: This menu entry copies the original configuration files from ~/torbox/etc to the right places on the system. Without selecting menu entry 4, this is only a complete reset of your TorBox configuration. In conjunction with the menu entry 4, the configuration is not only reset, but also updated to the newest version.

    Important
    All configuration files will be overwritten, and all your custom configuration will be lost!!

  • Menu entry 7: Reset network manager (anti-crash): Sometimes, the network manager has a problem with the stored wireless networks. This causes the program to crash if you try to change the configuration of a wireless network by using the right arrow key, or the program does not start at all. This menu entry resets the network manager so that it functions normally again. However, the stored wireless networks will be deleted.

  • Menu entry 8: Reset Tor and force a change of the permanent entry node: Sometimes, especially if you did not use TorBox for a longer time, Tor gets stuck during its boot process (for example, at “Bootstrapped 0%”). This menu entry resets Tor so that it functions normally again. Additionally, this menu entry enforces a change of the entry guard, which could be necessary if the entry guard is becoming unstable (this will be mentioned in the log file). Notice that enforcing a new exit node (main menu entry 2) does not change the entry guard, which, usually, remains for 2-3 months the same to protect against a known anonymity-breaking attack (for more information, see here).

  • Menu entry 10: Just fixing and cleaning: This menu entry synchronizes the system time (if possible), fixes, and cleans the installed packages. It also removes dependencies, which are not anymore necessary. Running this menu entry also fixes OBFS4 attributions and the tor service files.

• • •

Problems and questions

  • Tor did work without a problem. The Internet is reachable. Nevertheless, after a restart of TorBox, Tor does not load anymore. It is stuck at “Bootstrapped 0%” for more than 5 minutes! How can I fix that? –> see here.