Re-provisioning an agent

During the lifecycle of a robot, it is common to have to re-image or replace a robot. Rather than create a new device within Formant, you can re-provision your device to maintain its Formant identity and relation to existing data. Data will then appear as though it is from the same device.

Prior to re-provisioning a device, ensure that the agent is either stopped or uninstalled.


Once you begin the re-provisioning process, the device will be invalidated and will stop ingesting data.

Step 1: Uninstall the current Formant agent installation


Perform re-provisioning over a separate SSH connection, and not through the Formant web application. The connection to Formant will be broken when the original token is revoked.

Native Formant installation

Open a terminal or SSH connection to your device (not through the Formant app) and enter the following command:

sudo apt remove formant-agent --purge

Docker installation

If your agent is installed via Docker, run the following command:

sudo rm /var/lib/formant/credentials.toml

Step 2: Generate a new provisioning token

  1. In Formant, in the upper-left corner, open the menu and go to Settings >> Devices.
  2. Locate the device you want to re-provision. Click the three dots >> Reprovision. Confirm that you want to proceed by clicking OK.
  3. Copy the new provisioning script for your device, which will look like this:
bash <(wget -qO - <provisioning-token>

Step 3: Run new installation command

  1. Close out of the terminal you used in Step 1, and open a new terminal window.


The installation may not run properly if you use the same terminal window from Step 1.

  1. Paste the provisioning script from Step 2 and run it. This will install the Formant agent on your device with the same identity as the device you de-provisioned.


If you notice an issue with this page or need help, please reach out to us! Use the 'Did this page help you?' buttons below, or get in contact with our Customer Success team via the Intercom messenger in the bottom-right corner of this page, or at [email protected].