Skip to main content
Version: 10

Connect with the MoveIt Pro Desktop App

The MoveIt Pro desktop app is installed separately from the Runtime. Installers ship for Linux today, with macOS and Windows coming soon, and connect to a Runtime on any supported Runtime host operating system.

Install the App​

Install the app and the Runtime from Install MoveIt Pro, then return here for remote, multi-Runtime, and multi-version connections.

MoveIt Pro 10.0 requires the desktop app and Runtime to have the same release version. If the versions do not match, the app explains the problem before connecting. On Linux, run moveit_pro_desktop --version in a terminal to print which app build is installed.

You can keep multiple desktop-app releases installed side by side. This is useful when your Runtimes do not all use the same release: open the app release that matches the Runtime you want to connect to. Each app release can save connections to multiple Runtimes that use its matching release.

The desktop app does not update automatically. Download and install a new app release when you update a Runtime, and keep older app releases for any Runtimes that have not been updated yet.

Connect to a Runtime​

The first connection is part of installation. Follow Connect the Desktop App to a Runtime to discover a Runtime and save the connection. The rest of this page covers what comes after that first connection.

Switch or Recover a Connection​

  • Open Settings from the top navigation bar and select Runtime Connections to switch Runtimes.
  • To use multiple Runtimes at the same time, select File > New Window and connect each window to a different Runtime.
  • If a Runtime restarts, leave the app open. It reconnects when the Runtime is available again.
  • Select Choose Another Runtime during reconnection, or Connections after recovery stops, to return to the connection picker.
  • Edit a saved connection to replace or remove its frontend key, addresses, or service ports. Changing the primary address or ports requires entering the key again unless you remove it from the saved connection.

If the desktop app and Runtime are incompatible, the app explains the problem before connecting. For MoveIt Pro 10.0, install the desktop app and Runtime from the same release.

Runtime Ownership​

The desktop app does not start, stop, or store the Runtime workspace. Run moveit_pro run, moveit_pro down, build, backup, and migration commands on the Runtime computer. The user workspace remains there when the desktop app closes or is reinstalled.

Run the Runtime in Parallels on macOS​

macOS remains supported by running the MoveIt Pro Runtime in an Ubuntu virtual machine under Parallels and running the desktop app on macOS.

macOS installer availability

The macOS desktop app installer is coming soon. Until it ships, the download list on Install MoveIt Pro offers Linux installers only, so the steps below apply once that installer is available.

For the simplest connection:

  1. Start the Runtime inside the Ubuntu VM.
  2. Find the VM's hostname or IP address in its Parallels network settings.
  3. Open the desktop app on macOS, select Add Connection, and enter that hostname or IP address.

The Mac must be able to reach discovery port 3204 and Runtime ports 3200–3203 and 3205 in the VM. If the Parallels network does not provide that direct access but SSH works, create a tunnel from a macOS terminal:

ssh -N \
  -L 3200:127.0.0.1:3200 \
  -L 3201:127.0.0.1:3201 \
  -L 3202:127.0.0.1:3202 \
  -L 3203:127.0.0.1:3203 \
  -L 3204:127.0.0.1:3204 \
  -L 3205:127.0.0.1:3205 \
  <vm-user>@<vm-hostname-or-ip>

Keep that terminal open, then add 127.0.0.1 as the connection in the desktop app. The command is expected to remain open without showing a prompt. Port 3203 uses the Runtime's TCP fallback for camera media when connected through the SSH tunnel.

Port 80 is not required. It belonged to the former Compose-hosted browser interface, which the desktop app replaces for self-hosted MoveIt Pro 10.0.

MoveIt Pro Cloud remains available through its browser interface, but it is simulation only and cannot be connected to robot hardware. Self-hosted MoveIt Pro 10.0 Runtime deployments use the desktop app.