Configure SSH

Windows

1. Open PowerShell and type ssh -V. You should see what version of SSH you are running. If you receive an error, your computer is not automatically compatible with SSH.

2. In the same window, type type ~\.ssh\id_rsa.pub. If you receive an error that the file does not exist, proceed to the next step. Otherwise, proceed to step #4

3. Type ssh-keygen. Press enter on all prompts to select the default options.

4. Connect to the rover over ssh using the appropriate command stated in the "Rover boot procedure" tutorial. When asked if you want to continue connecting, type yes and press enter.

5. Next you will be prompted for the password. Type in the password and press enter. NOTE you will not see characters appear on screen while typing the password.

Mac/Linux

1. Open terminal and type cat ~/.ssh/id_rsa.pub If you receive an error that the file does not exist, proceed to the next step. Otherwise proceed to step #3.

2. Type ssh-keygen. Press enter on all prompts to select the default options.

3. Connect to the rover over ssh using the appropriate command stated in the "Rover boot procedure" tutorial. When asked if you want to continue connecting, type yes and press enter.

4. Next you will be prompted for the password. Type in the password and press enter. NOTE you will not see characters appear on screen while typing the password.

Optional Steps

There are a few things you can configure SSH to make connecting to the rover easier.

Connect without asking for password

1. On a windows machine, open PowerShell and type type ~\.ssh\id_rsa.pub. On a Mac or linux computer, open Terminal and type cat ~/.ssh/id_rsa.pub. Copy the entire output of this file (including the starting ssh-rsa)

2. Login to the Jetson TX2 (either over the base station antenna or Mac WiFi). Type echo "PASTE_STEP1_FILE_CONTENTS_HERE" >> ~/.ssh/authorized_keys, replacing the appropriate field with what you copied in step 1.

3. Disconnect from the jetson. Next time you login with ssh, you should not be asked for a password

Connection Aliases

1. On a windows machine, open PowerShell and type ni ~\.ssh\config. If you get an error that the file already exists, continue to step 2. On a Mac or Linux computer, open Terminal and type touch ~/.ssh/config.

2. On a windows machine, type notepad ~\.ssh\config. On a Mac, type open -a TextEdit ~/.ssh/config. On a Linux machine (with gnome), type gedit ~/.ssh/config.

3. Paste the following into the bottom of the config file. Then save and close the text editor.

   Host jetson1
       HostName jetson1.marsatmac.ca
       User mmrt
   Host jetson1-antenna
       HostName 192.168.1.110
       User mmrt
   

4. Close and re-open your PowerShell or Terminal session. You should now be able to login to the jetson by typing ssh jetson1 or ssh jetson1-antenna (depending on whether you're connecting over Mac-WiFi or with the Rocket M2 antenna).