UI Guide

File Manager

Browse, edit, upload, and manage files directly on the host filesystem.

The File Manager is a browser-based file explorer for the host filesystem. It reflects FlatRun's flat-file philosophy: deployment configs and data are plain files on disk, and you can work with them directly instead of through hidden volumes.

Browsing

  • Navigate directories starting from the host root or your home directory.
  • Each entry shows its name, size, modified time, and permissions.
  • Toggle hidden files from Settings → General.

Actions

ActionWhat it does
Open / editView and edit text files in place
UploadSend files from your machine into the current directory
DownloadSave a file to your machine
New folderCreate a directory
New fileCreate an empty file
PermissionsChange a file's mode (chmod)
DeleteRemove a file or directory

Per-Deployment Files

Each deployment also has its own scoped file browser on its detail page, rooted at that app's directory. Use it to edit a single app's docker-compose.yml, config, or data without navigating the whole host.

This edits real files. Changes here affect the running system immediately. Editing a compose file or deleting data can break a deployment; back up before large changes.
Star us on GitHub