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.gzwith 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.