Skip to main content

Foxlet state

Foxlet 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 Foxlet 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 Foxlet'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 Foxlet connects to Foxglove, two things happen concurrently:

  • Foxglove marks previous recordings as unavailable for import (as though you had deleted them locally)
  • Foxlet 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 Foxlet's state. See the FAQ for common scenarios that require a database reset.