Appearance

Files Tab ​

The Files tab allows you to browse, import, and manage files within your sandbox containers. Import files via drag-drop, open files with configured applications, and organize your sandbox storage.

What you'll learn

  • Browsing sandbox files
  • Importing files via drag and drop
  • File operations (open, delete)
  • Shared storage configuration
  • Policy-controlled file operations

Overview ​

Files Tab

The Files tab provides a file browser interface for your sandbox storage. It displays the shared storage location configured in your policy.

Configuration Requirements ​

The Files tab requires exactly one mount container to be configured in your policy. The container is specified using the --mount flag in your policy's turbo flags.

Valid Configuration ​

When your policy configures a single mount container, the Files tab displays the shared storage location, showing "Home" in the breadcrumb. You can browse folders and files within this location. You cannot navigate above the shared storage root.

Invalid Configuration ​

If your policy has zero mount containers or multiple mount containers configured, the Files tab displays an error message: "File storage is not configured". Use the Retry button after correcting your policy configuration.

  • Click folders to navigate into them
  • Back button to navigate to the parent folder
  • Breadcrumb shows your current location with friendly folder names
  • F5 key to manually refresh the file list

The file list updates automatically every 30 seconds to reflect changes.

Importing Files ​

Drag and drop files from Windows Explorer onto the Files tab to import them into your sandbox.

Progress Tracking ​

For larger imports (5+ files or 10MB+ total size), a progress dialog displays:

  • Overall progress across all files
  • Current file being imported
  • Estimated items remaining
  • Cancel button to stop the import

Import Progress Dialog

Import Errors ​

If a file fails to import, an error dialog appears with:

  • The filename that failed
  • The error message
  • Detailed error information (expandable)
  • Options to Try Again, Skip, or Cancel the entire import

File Operations ​

Opening Files ​

Click a file or use the context menu "Open" option to open it. The file opens with the handler application configured in your policy's file associations.

If no file association is configured for the file type, an error message is displayed.

Deleting Files ​

Right-click a file or folder and select "Delete" from the context menu. A confirmation dialog appears before deletion. Folder deletion is recursive (deletes all contents).

Policy Control ​

File operations are controlled by your policy configuration:

  • Import: Controls which file types can be imported into the sandbox
  • Open: Controls which files can be opened
  • Delete: Controls which files can be deleted
  • List: Controls which files are visible in the file browser

Your policy can configure specific applications to handle certain file types. See Policy System - File Policies for configuration details.

Next Steps ​

Turbo.net © 2025