Skip to main content

Upgrade Guide

With each upgrade, we bring new capabilities and improvements to your RemotiveBroker.

To enjoy the latest broker experience, we recommend that you regularly update it.

This guide focuses on how to upgrade the broker and the broker app running on RemotiveBox. The process is similar for other hardware devices. If you need help, we are happy to help. If you use the Docker images in a CI pipeline or similar, perform an upgrade as with any other Docker image.


  • First, make sure your device is plugged into the power source. Give it a few seconds to boot up.
  • Connect your device to the internet with a LAN cable.
  • Ensure the box is configured with a valid license.

Please note that connecting your computer to the device's Wi-Fi hotspot isn't enough for the purposes of performing an upgrade because, while you'll be able to interact with the device, the device itself won't have access to the internet.

1. Open RemotiveBrokerApp

We will use RemotiveBrokerApp to initiate an upgrade.

The easiest way to open the app is to use RemotiveCLI.

Run the remotive broker discover command to find brokers connected to your network.

➜  ~ remotive broker discover

Looking for RemotiveBrokers on your network, press Ctrl-C to exit...

[ RemotiveBroker GRPC on remotive-broker-office-1._remotivebroker._tcp.local. ]
RemotiveBrokerApp: http://fe80::96cc:5a4c:93f1:b2b0:8080
RemotiveBroker http://fe80::96cc:5a4c:93f1:b2b0:50051

If your broker doesn't appear on the list, ensure that it is connected to your network with a LAN cable and that your computer is also connected to the same network (either wirelessly or with a cable).

Open the app URL in a web browser.

2. Initiate the Upgrade

To initiate the upgrade, navigate to the About page.

About page before the upgrade

When an upgrade is available, the "Upgrade" button will appear. Click on it to show the upgrade dialog.

If you wish to upgrade to the latest versions of the broker and the app, leave the two input fields empty and continue with a click on "Upgrade."

Update dialog

The upgrade is now in progress. Close the popup and wait for a few minutes.

Update in progress alert

In a few seconds, a notification will appear that will prompt you to wait.

Update in progress screen

After a few minutes, the upgrade is complete.

Update in progress screen

Congratulations! It's time to enjoy the latest RemotiveBroker experience. 🎉