File Manager
Browse, edit, upload, download, and manage files on your Devpilot servers through the built-in SFTP file manager.
File Manager
The Devpilot File Manager is a remote file browser backed by SFTP over the server's existing SSH session. You can navigate the file system, create and edit files, upload and download content, change permissions, and work with archives — all without leaving the dashboard.
Opening the File Manager
Go to Servers, select a server, and open the File Manager tab. The file list shows each entry with name, size, permissions, owner, and last modified time.
Navigating
Breadcrumb
The breadcrumb at the top shows your current path. Click any segment to jump directly to that directory.
Entering folders
Double-click a folder to open it. The view updates and the breadcrumb reflects the new path.
Hidden files
Entries that begin with a dot (.env, .htaccess, .git) are hidden by default. Toggle Show Hidden Files in the toolbar to reveal them.
Dotfiles often hold sensitive data — environment variables, API keys, database credentials. Be careful when viewing or sharing their contents.
Creating Files and Folders
New file
- Click New File in the toolbar.
- Enter the filename including the extension.
- Click Create. The file is created in the current directory and opens in the editor.
New folder
- Click New Folder.
- Enter the name.
- Click Create.
Editing Files
Select a file and click Edit, or double-click to open it in the built-in code editor. The editor includes syntax highlighting for common languages and configuration formats. Click Save to write changes back to the server.
Editing files under /etc (for example nginx, Apache, or SSH configs) can break services. Take a copy before changing anything, and verify the affected service restarts cleanly afterward.
Uploading Files
Open the upload dialog
Click Upload in the toolbar.
Pick files
Drag and drop or choose files. Multiple files can be queued at once.
Start the upload
Click Upload. Each file streams to the current directory with a progress indicator.
For very large files, or for files you need to pull directly from another host, use the Web Terminal with wget, curl, rsync, or scp. For moving files between two servers in your workspace, use File Transfer.
Downloading Files
Select a file and click Download. To download a whole directory, compress it first (see below) and download the resulting archive.
Renaming, Moving, Deleting
- Rename — Select, click Rename, and enter the new name.
- Move — Select, click Move, and enter the destination path.
- Delete — Select and click Delete. Confirm to remove.
There is no recycle bin. Deleted files can't be recovered from the file manager — make sure you have a backup before removing anything under /var/www, /etc, or application data directories.
Permissions
The file manager shows UNIX permissions for every entry. To change them:
- Select the file or folder.
- Click Permissions.
- Enter octal permissions (for example
755) or toggle read/write/execute per owner, group, and others. - For folders you can apply recursively.
- Click Save.
Common permission values
| Octal | Symbolic | Typical use |
|---|---|---|
644 | rw-r--r-- | Regular files (HTML, CSS, PHP, configs). |
755 | rwxr-xr-x | Executables and directories. |
600 | rw------- | Private files (SSH keys, .env). |
700 | rwx------ | Private directories. |
775 | rwxrwxr-x | Shared group directories. |
Incorrect permissions are the most common cause of 403 Forbidden and Permission Denied errors in web applications. If an app starts failing after a transfer, check that the web server user can read the files and traverse the directories.
Compressing and Extracting
Compressing
- Select files/folders.
- Click Compress.
- Pick the format (ZIP or tar.gz).
- Enter an archive name.
- Click Compress.
Extracting
- Select a
.zip,.tar.gz, or.tarfile. - Click Extract.
- Pick the destination directory (defaults to current).
- Click Extract.
Calculating Folder Sizes
Select a folder and click Calculate Size to scan recursively and return the total. This is the quickest way to find the culprit in a /var/log, /tmp, or uploads directory that's eating disk.
Tips
- Double-click to enter a folder or open a file in the editor.
- Right-click for the full context menu.
- Type paths directly into the breadcrumb input and press Enter to jump.
- Toggle Show Hidden Files when debugging dotfiles.
Next Steps
- Web Terminal — Drop to the command line for tasks the file manager can't do.
- File Transfer — Move files between two servers in your workspace.
- Backups — Protect the files you edit here with scheduled or real-time backup plans.