Troubleshooting

The usual reasons a device or a shell does not come up.

The device never shows as connected

• Check that the agent runs: systemctl status rescueshell-agent, or without systemd ps -ef | grep rescueshell-agent.
• Read its log: journalctl -u rescueshell-agent, or /var/log/rescueshell-agent.log.
• The device needs outbound HTTPS to the relay. Nothing inbound.

The agent says its credential was rejected

The device was removed from your team, or the token was wrong or expired. Create a new token under Add device and run the install command again with --reregister.

The shell does not open

The device's OpenSSH server does not read session keys yet. Run the install command again, with the same trust flags. If you installed with --no-sshd, add the printed lines to sshd_config and reload sshd.

Host key changed

The device was reinstalled or its keys were replaced. An admin checks that it is the right device, then accepts the new key on the Devices page.

The Devices page says the agent is outdated

Run the same install command again. It keeps the registration.

Still stuck

Mail support@rescueshell.com with the device name and what you see.