Linux client only shows as 'Offline' in user-profile 'Devices' tab

Use this page when a Linux device with the backup app installed doesn't show as Online on the user's Devices tab in the Web Portal. There are two versions of the problem:

The device is listed but shows Offline: it registered at least once, but the Web Portal can't reach it now.
The device isn't listed at all: it never registered with the user account.

Either way, it almost always comes down to one of two causes: the backup app isn't running on the device, or it can't reach the Magnus Box server. The commands below use the default install folder /opt/MagnusBox/. If your app is branded, the folder follows your branding.

The device is listed but shows Offline

Check that the backup app is running

.deb or .rpm install: check the service with sudo systemctl status backup-tool, restart it with sudo systemctl restart backup-tool, and read its log with sudo journalctl -u backup-tool.
.run installer (from the .tar.gz download): check for the app's processes with ps aux | grep -i backup. You should see lines similar to these:
```
root <snip> /bin/bash /opt/MagnusBox/backup-daemon-start.sh
root <snip> /opt/MagnusBox/backup-tool cmd -ValidateConfig=false -Action=delegate-server
root <snip> ./backup-tool cmd -Action dispatch -Username <username> -Server <yourURL> -PasswordOnStdin
```
If they're missing, start the app with sudo /opt/MagnusBox/backup-daemon-start-background.sh & and check that your startup entry (systemd unit, rc.local or crontab @reboot line) is still in place. See Linux Installation.
If the processes still don't appear, reinstall the backup app.

Check that the device can reach the server

See Test the connection to the server below.

The device isn't listed at all

Check that the app is running, as described under The device is listed but shows Offline.
Check that it has been logged in and registered with the client's username and password. To log in and register, run sudo /opt/MagnusBox/backup-tool login prompt. See Device registration.
If the app is running and logged in but the device still doesn't appear, test the connection to the server.

Test the connection to the server

You can simulate a login from the device to check that it can reach the Magnus Box server. Run this command on the device. Replace <username> and <password> with the client's login, and <yourURL> with your Web Portal address (for example https://backup.yourcompany.com):

curl -v -X POST --data-urlencode "Username=<username>" --data-urlencode "AuthType=Password" --data-urlencode "Password=<password>" <yourURL>/api/v1/user/web/session/start

The password is typed on the command line, so clear it from your shell history afterwards.

A successful login returns output similar to this, which confirms the device can reach the server:

{"SessionKey":"abc1fd20-7177-12362-88ba-863efgfe07b0","SessionType":"user","Status":200,"Message":"Logged in OK."}

Any failure points to the cause, for example a wrong password, DNS, a proxy or firewall blocking the connection, or no network. Fix that, then check the device again in the Web Portal.

Still stuck? Email support@magnusbox.com with the user name, the device name, the Linux distribution and version, and the output of sudo journalctl -u backup-tool or the test above (remove the password first).