Introduction

SSH is a way to connect to and control your OT-2 over the command line. It is required for some troubleshooting and advanced tasks.

Before Starting

SSH requires some first-time setup. Before following these instructions, make sure you've completed the setup guide:

Once that's done, you're ready to connect.

1. Find Your OT-2's IP Address

In the Opentrons App, find the OT-2 that you want to connect to. Note its Wired IP or Wireless IP. 

  • If you use the Wired IP, the SSH connection will be made over USB.
  • If you use the Wireless IP, the connection will be made over Wi-Fi.

Prefer the Wired IP, if you can. The connection will be more reliable.

These IP addresses will change periodically, especially after the OT-2 is restarted or reconnected. You should double-check the IP address each time you want to make an SSH connection.

2. Connect

Open a PowerShell window if you're on Windows 10, or a Terminal window if you're on Linux or macOS.

Enter the following command. Replace ROBOT_IP  with the IP address you found above.

ssh -i ot2_ssh_key root@ROBOT_IP

Connection Warnings

You may see a short warning saying "Permanently added [IP address] to the list of known hosts." You can safely ignore it.

3. After Connecting

If the connection worked, you'll be greeted by the Opentrons logo. ✨

Try running some commands on your OT-2. For example, enter the command: 

whoami

You should see the command output root .

Did this answer your question?