Sub-menu: Update and Maintenance

The update and maintenance sub-menu of TorBox v.0.5.0.
The update and maintenance sub-menu of TorBox v.0.5.0.

The primary purpose of this sub-menu is to offer a simple way to update TorBox and perform some maintenance tasks. In the following, we look at all menu entries one by one:

Before the update starts, the current version of the installed Linux kernel and Tor is displayed.
Before the update starts, the current version of the installed Linux kernel and Tor is displayed.
  • Menu entry 1: Update the base system: This menu entry updates your base system, including the Linux kernel. Before the update starts, the current version of the installed Linux kernel and Tor is displayed. The update starts after another confirmation. The update procedure can last up to 30 minutes. The update runs in a screen session, meaning that if you close the SSH client or lose the 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 update’s progress. Do not remove power from your TorBox during the update. A reboot is highly recommended after an update and is necessary to load a new kernel.

    Important
    .
    • Updating the Linux kernel may mean that the additional network drivers are not supported anymore. Currently, the latest supported kernel is version 5.10.73 (see here). You can switch back to this kernel by executing the following command on TorBox’s command prompt:
      cd ~/torbox
      bash install/step_back_to_kernel_5.10.73.
    • Afterwards, you must run entry 2 to update the additional network drivers for the Linux kernel 5.10.73.
    • Updating the base system may also install an older version of Tor. In this case, please rerun entry 4.
    • Updating the base system doesn’t update the TorBox menu, but you can use entry 5.
  • Menu entry 2: Update additional network drivers: This menu entry updates the additional installed network drivers (Realtek 8188eu, 8188fu, 8192eu, 8812au, 8812bu, 8814au, 8821au, 8821cu, and 8822bu). This should simplify the use of 5 GHz band wireless networks.

    Important
    .
    • The network drivers must support the installed Linux kernel (currently: version 5.10.73; see here), otherwise, the drivers will not work. These network drivers must be reinstalled if you update the Linux kernel.
  • Menu entry 3: 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 4: Update or change the version of Tor: This menu entry updates or changes the installed tor version. It can be chosen between “DEFAULT” and “EXPERT”, where “DEFAULT” installs the latest stable tor version and “EXPERT” gives access to a variety of tor versions, including the -rc and -alpha versions (which is not recommended to use).

    The update runs in a screen session, meaning that if you close the SSH client or 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 update’s progress.

    Important
    .
    • In the “DEFAULT” mode, the current version of the installed Linux kernel and Tor is displayed before the update starts, which is the case after another confirmation. The update procedure can last up to 30 minutes. Do not remove power from your TorBox during the update.
The "EXPERT" button showing up with choosing entry 4 in the Update and Reset sub-menu gives a list of possible tor versions.
The “EXPERT” button showing up with choosing entry 4 in the Update and Reset sub-menu gives a list of possible tor versions.
  • Menu entry 5: Update the TorBox menu: 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 update / change TorBox’s configuration files if necessary.

  • Menu entry 6: Reset TorBox’s configuration files: This menu entry copies the original configuration files from ~/torbox/etc to the right places on the system.

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

  • Menu entry 7: Reset TWM and erase all wifi passwords: Does what it says!

  • 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 becomes 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 to protect against a known anonymity-breaking attack (for more information, see here).

  • Menu entry 9: Restart TFS and/or Nginx to re-share on an Onion domain: Does what it says!

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

  • Menu entry 12: 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 has been stuck at “Bootstrapped 0%” for more than 5 minutes! How can I fix that? –> see here.
  • I saw that TorBox is using Google’s and Cloudflare’s DNS server as well as google.com to test connectivity? Can’t you change it to xyz.dns? –> see here.