Skip to content

Guides

Files

The IDE-grade file workspace: tree, editor, archives, uploads, trash and safe operations.

Updated Edit this page on GitHub

The Files module is a real file workspace — every operation touches the actual filesystem and is audit-logged.

The workspace

  • Tree — lazy-loaded directory tree rooted at the panel's data directory (site docroots, databases, backups, app volumes), with per-role access.
  • Editor — Monaco (the VS Code editor) with syntax highlighting for code and config; unsaved-changes indicator and Ctrl/Cmd+S save.
  • Search — quick file-name search across the tree.

Operations

  • Create / rename / move / copy / delete files and folders (delete goes to the trash with restore).
  • Upload files (drag & drop), download files, and archive/extract .zip / .tar.gz with zip-slip and size protection.
  • Permissions and ownership shown per node; disk usage per directory.

Safety

  • All paths are canonicalised and jailed to the allowed root — traversal attempts are rejected.
  • Blocked system paths (/proc, /sys, /dev, /boot, the panel's own keys) are denied for writes.
  • Heavy operations are rate-limited per session.