Sub-menu: Update and Maintenance

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

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.
    • You must run entry 2 to update the additional network drivers in this case.
    • Updating the base system may also install an older version of Tor. In this case, please rerun entry 4.
    • However, 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.
  • 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 maintenance 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.

    Choosing “DEFAULT” will install the newest TorBox menu from the master branch of TorBox’s GitHub repository. “EXPERT” let you install the TorBox menu from another fork or branch.

  • 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 10: Force to deactivate the OBFS4 mode: Unfortunately, in TorBox v.0.5.0, we had a nasty little bug preventing TorBox from deactivating the OBFS4 lines in the tor configuration file. Because we had a similar bug way back in the past, we decided to let this option stay in the update and maintenance sub-menu. However, if not needed, we will probably remove this menu entry in one of the following versions.

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

  • Menu entry 13: 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.
  • Why is the local TorBox traffic not routed through tor? Why is by default Google’s and/or Cloudflare’s service used to circumvent cheap censorship measures or to test the connectivity? Can I change Google and/or Cloudflare services with something else? –> see here.