Skip to main content

Factory Reset

To run factory reset from command line see here, explained in factory-reset command. Make sure you have the following files available:

  • A valid nimbus.json
  • A valid robots.json

What Factory Reset does​

Factory Reset clears all local data and returns the agent to a fresh local state.

From a user perspective, it resets:

  • Local robot presets
  • Local fleet presets
  • Local fleet robot definitions
  • Local configuration history
  • Local settings and cached state
  • Local identity cache (will be rebuilt from nimbus.json or the backend)

After a Factory Reset:

  • The agent must be restarted
  • On the next start, preset files (if present on disk) will be picked up again

What Factory Reset does not do​

Factory Reset does not:

  • Delete nimbus.json
  • Delete preset files on disk
  • Uninstall the agent
  • Remove robots or fleets from the cloud backend

Typical use cases​

  • Applying updated preset files
  • Recovering from inconsistent local state
  • Resetting a robot to a clean local setup
  • Rebuilding local data while keeping the same installation