Skip to content

Installing the App

Start here for step-by-step instructions for downloading, installing, and updating the Opentrons App.

App installation

Download the Opentrons App from opentrons.com/ot-app. The latest version of the app requires Windows 10, macOS 11, or Ubuntu 20.04 or later. The app may run on other Linux distributions, but Opentrons does not officially support them.

Windows

The Windows version of the Opentrons App is packaged as an installer. To use it:

  1. Open the .exe file you downloaded from opentrons.com.

  2. Follow the instructions in the installer. You can install the app for a single user or all users of the computer.

The app opens automatically once installed. Grant it security or firewall permissions, if prompted, to make sure the app can launch and communicate with the OT-2 over your network.

macOS

The macOS version of the Opentrons App is packaged as a disk image. To use it:

  1. Open the .dmg file you downloaded from opentrons.com. A window for the disk image will open in Finder.

  2. Drag the Opentrons icon onto the Applications icon in the window.

  3. Double-click on the Applications icon.

  4. Double-click on the Opentrons icon in the Applications folder.

Grant the app security or firewall permissions, if prompted, to make sure it can launch and communicate with the OT-2 over your network.

Ubuntu

The Ubuntu version of the Opentrons App is packaged as an AppImage. To use it:

  1. Move the .AppImage file you downloaded from opentrons.com to your Desktop or Applications folder.

  2. Right-click the .AppImage file and choose Properties.

  3. Click the Permissions tab. Then check Allow executing file as a program. Close the Properties window.

  4. Double-click the .AppImage file.

Note

Do not use third-party AppImage launchers with the Opentrons App. They may interfere with app updates. Opentrons does not support using third-party launchers to control Opentrons robots.

App software updates

The app displays a notification when Opentrons releases new software versions. To update the app, click the link to view the update and automatically install the latest version.