TetherBox Troubleshooting Login

This is the process to gain emergency command line login, to perform actions such as manually connecting the TetherBox to the network.

Roman Gaufman avatar
Written by Roman Gaufman
Updated over a week ago


Note: These steps can be dangerous and should only be followed if explicitly requested by a member of the TetherX support team.

This process allows you to perform operating-system-level changes to your unit and should not be required under normal circumstances. Please note that doing so can risk potentially damaging the firmware of the TetherBox, which can only be repaired by returning the unit back to TetherX.

Gaining Emergency Login

1. Reboot the TetherBox

2. Prio to booting the screen will show "GRUB" menu fr a few second.

GRUB menu

3. Use the down arrow on your keyboard to highlight "Advanced options" then press the "enter" key. You will see the following sub-menu:

4. Use the down arrow on your keyboard to highlight the first row that contains the words "recovery mode", press "enter" to select it.

5. Depending on your version you may see the following menu, if so, select the root (Drop to root shell prompt) option, and press "enter" to select.

Note: on some versions you will see "Press Enter for Maintenance" instead. If you see this, press enter:

7. If a password is requested, this can be generated and supplied by your TetherX team

Note: This password is unique for every unit.

8. You are now in the terminal.

Manually Connecting to the Network


Once you are logged into the unit, you will be able to make certain manual changes. For example, forcing it to connect to the network.

Try to ping your router:

If you see this message then your device does not have an IP address assigned.

If you see 100% packet loss, then your device has an IP address but is on different networks with your router.

If you see such a message and all packets have been received, then this means that your device has an IP address and is on the same network as the router.

Warning: All examples use the enp0s3 interface, but your interface may differ from this. Please replace the enp0s3 interface in all commands with yours.

Warning: The examples use IP addresses and their ranges, which may be different from yours. You should replace the IP addresses and their masks with those available on your network.

Please make any changes carefully.

How to get an IP address from a DHCP server

1. An example when the interface does not have an IP address:

To find out which interface your device is using, enter the ifconfig -a command.

You will see several interfaces, select the one that should be used as the main interface for Internet access (This is usually the first interface).

2. To get an IP address from your DHCP server:

Enter the dhclient -v enp0s3 command to have your device send a request to your DHCP server for an IP address.

Note: Usually, the DHCP server is a router, make sure the router is turned on and working and the TetherBox is connected.

3. TetherBox got IP address from DHCP server:

Now you can see the inet line and the IP address that was assigned to your unit in the interface information. To view this information, use the ifconfig command.

Note: If the unit was unable to obtain an IP address from your DHCP server for some reason, you can still try to configure it manually. Please contact support so we can help you with the configuring.

How to set a manual IP if needed

1. Assigning an IP address to an interface manually:

Enter the command:
ifconfig enp0s3 netmask up
to assign an IP address and subnet mask to the interface.

Enter the command:
route add default gw
to set the default gateway.

Note: Replace the interface in the example with the one you see in your unit. Also, replace the IP address, gateway and subnet mask with those available on your network.

2. Set up a DNS server for internet access:

Enter the command:
echo "nameserver" > /etc/resolv.conf

to set up Google DNS Server.

Enter the command:
cat /etc/resolv.conf

to check your resolv.conf file (It should have the "nameserver" line that we just added).

Check ifconfig -a:

How to set a Static IP

1. Use vi /etc/netplan/enp0s3.yaml to open interface config file:

2. You'll see the standard config. Example:

3. Using the arrows on the keyboard, you can navigate the text file, to enter the editing mode, press Insert (-- INSERT -- will appear at the bottom). Press Esc to exit edit mode.

4. Edit the config as follows:

5. Save the changes by pressing Esc, then put the double character ":" and write "wq":

6. Apply new configuration

Enter the command:
netplan try
to check your edited config file. If you see that everything is working well and the timer is running press "Enter" to accept the changes.

Note: If the command was executed with an error and the timer was not started, then you made a mistake in the configuration file.

The information that is displayed after the command will point you to the place of the error:

Correct the mistake and try again.

How to check if the unit gets IP and access the Internet

Use ifconfig -a to check that the TetherBox has an IP address:

Use ping -c4 google.com for check that the TetherBox has access to the Internet:

All packages must be received and 0% packet loss.

If you are not able to bring the unit online, please fill in the form on our support page providing screenshots of the above for a member of our support team to assist further.

Did this answer your question?