Skip to main content

Agent state

The Agent maintains a local SQLite database to track its state. By default, this is stored at $VARDIR/controller.db.

What the database stores​

  • The device ID associated with this Agent installation
  • Metadata for local recordings that have been reported to Foxglove
  • State for data uploads requested from the Foxglove app

Resetting the database​

To reset the Agent's local state, ensure that it is not running, and then delete its database files:

rm $VARDIR/controller.db*

When using the .deb package, $VARDIR defaults to /var/lib/foxglove/agent. When using Docker, delete the contents of the volume mounted at /index.

What happens after a reset​

After the database is deleted, the next time the Agent connects to Foxglove, two things happen concurrently:

  • Foxglove marks previous recordings as unavailable for import (as though you had deleted them locally)
  • The Agent reindexes all local files, and reports them as available for import

Eventually, the set of recordings available for import in Foxglove will match the set of local files on the device.

This is a safe recovery path if the database becomes corrupted, or if you need to reset the Agent's state. See the FAQ for common scenarios that require a database reset.