The primary purpose of this sub-menu is to offer a simple way to update and reset your TorBox. This sub-menu is designed differently than the others. 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 (Raspbery Pi OS), including the kernel. In general, it automatically updates also the firmware and Tor. You don’t have additionally 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 start “screen -x” to see the progress of the update.
- Before the update starts, the current version of installed Linux, Tor, and Wicd is displayed. Only after another confirmation, the update starts.
- 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.
- 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 stable 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 doesn’t 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.
- Menu entry 4: Update to the newest stable version of TorBox: This menu entry fetches and installs the latest 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 it is necessary to 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.
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 didn’t use TorBox for a more extended period of time, Tor sticks during its boot process (for example, at “Bootstrapped 0%”). This menu entry resets Tor so that it functions normally again. Additionally, this menu entry also enforces a change of the entry guard, which could be necessary if the entry guard is becoming more and more unstable (this is 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 9: Remove permanently Bridge Relay data: All entries above does not touch your Bridge Relay data, which is important if you like to run a stable Bridge Relay for a long time. This menu entry permanently deletes the Bridge Relay data on your TorBox.
- Menu entry 10: Just fixing and cleaning: This menu entry fixes and cleans the installed packages. It removes dependencies, which are not anymore necessary. Running this menu entry fixes obfs4 attributions and the tor service files. More is probably coming soon…
• • •
Problems and questions
- Tor did work without a problem. The Internet is reachable. Nevertheless, after a restart of TorBox, Tor doesn’t load anymore. It is stuck at “Bootstrapped 0%” for more than 5 minutes! How can I fix that? –> see here.