Device Settings: Enable Remote SSH

Time to complete: 5 minutes

SSH access is crucial for remote support and debugging of robots deployed in the field.

Freedom uses reverse port forwarding to allow you to access your robot anywhere, even through firewalls: as long as your robot has an internet connection, you can connect to it securely.

Enable remote SSH

To start an SSH session, select your robot, navigate to SETTINGS → REMOTE SSH, and click ENABLE REMOTE SSH.
After a few moments, the SSH command will appear. It will look like this:

ssh [email protected] -p ...

Click COPY TO CLIPBOARD and run in your terminal. When prompted to continue, type yes. When asked, enter your password.

Congratulations! You have successfully started an SSH session with your robot.

Applications

Now that you have remote SSH access to your robot, you can do things like:

  • Enable remote troubleshooting for robots deployed in the field
  • Extract log and configuration files for offline analysis
  • Run rviz remotely to introspect ROS data
  • Develop software headlessly using PyCharm, VS Code, or your favorite code editor