Skip to main content

Files Tab (Device View)

The Files tab lets you browse and manage the device’s filesystem (within the agent’s allowed scope). Use it for quick inspections, config edits, and moving artifacts.

Navigation

  • Breadcrumbs: Click any segment to jump back up the path.
  • Hidden files: Toggle to show dotfiles (e.g., .env, .ssh).
  • Refresh: Reload the current directory to reflect out‑of‑band changes.

Columns

  • Name, Type (file/folder/link), Size, Modified, Owner, Mode/Permissions.

Actions

  • New
    • New file: Creates an empty file in the current folder. You can edit it immediately in the inline editor.
    • New folder: Creates a subdirectory.
  • Upload/Download
    • Upload: select files; large uploads show progress. Conflicts prompt overwrite confirmation.
    • Download: Download a single file; for folders, use “Download as archive” if available.
  • Edit/View
    • Inline editor for text files (YAML, JSON, .env, scripts). Syntax highlighting is applied based on extension.
    • Save creates a new version on disk; failures are reported in Events.
  • Copy/Move/Rename
    • Copy: Duplicate a file/folder to another path.
    • Move: Move a file/folder; useful for atomic config switches (write to temp, move into place).
    • Rename: Change the name in the same directory.
  • Delete
    • Removes the file/folder. For folders, you’ll be asked to confirm recursive deletion.

Safety and audit

  • All file operations are recorded in Events with who/when/what.
  • Be careful under system paths (/etc, /var); a mistake can disrupt services.

Tips

  • Use templates for repeatable config; use Files for one‑off fixes and investigations.
  • Keep secrets out of world‑readable paths; prefer Variables marked secret and mount as env or files via templates.