Skip to main content

Files

Use the Files page to manage non-recording resources uploaded from a robot, local Agent UI, or cloud storage sync.

Files are separate from the Recordings page. Use Recordings for video, event, and CSV recording timelines, and use Files for additional resources such as logs, exported data, maps, meshes, and manually uploaded artifacts.

Upload Files​

From the Files tab, upload files that should be stored with the robot resources.

Files tab upload option

Use the file-type filters to narrow the list by resource type, then click Upload File to add a new file to the robot resources.

Uploaded files preserve:

  • The original filename.
  • Stable download links.
  • File metadata.
  • File-type filtering used by the resource selector.

Edge-to-Cloud File Sync​

The Agent can discover and sync files that are copied directly onto the robot.

When running in cloud storage or AWS storage mode:

  • Files manually copied into /var/lib/nimbus/data/ are discovered automatically.
  • Files without recording metadata are moved into /var/lib/nimbus/files/import/ and synced as regular files.
  • The Agent scans /var/lib/nimbus/data/ every 2-5 minutes.
  • The import folder reacts to file changes and also runs a backup scan every 2 minutes.
  • Newly copied files must remain unchanged for at least 10 seconds before import.
  • Newly discovered files may wait about one minute before upload so partially written files are not uploaded too early.

Use Nimbus File Sync to trigger the full discovery, preparation, and upload flow manually.

Storage Cleanup​

File syncing and cleanup coordinate with active uploads. This prevents the Agent from deleting local files while they are still being prepared or uploaded.

In AWS storage mode, the Agent verifies file size and content before removing a matching local file after upload.

Using Files in Viewers​

Robot files can be selected by Monitoring viewers that support file-backed resources. For example, the 3D Viewer can use mesh and CSV files from the robot without requiring the operator to type a file path manually.