File Manager
Browse, upload, edit, and organise files on your server visually, no command line needed.
The File Manager turns your server's filesystem into something you can click through, just like Finder or Explorer. Drag in a file to upload it, double-click a folder to enter, edit a config file in place, and unzip an archive without typing a single command.
What you can do here
- Browse any folder on your server, all the way down to single files.
- Upload single files, multiple files, or whole folders, including by drag-and-drop.
- Download any file to your computer.
- Create new folders.
- Rename, delete, and copy the path of any item.
- Edit text files (configs, scripts, env files) right inside the app.
- Unzip
.ziparchives in place with one click. - Search and filter the current folder.
Open the File Manager
Open app → Click your server → File Manager tab (default tab when you connect)
You land in the user's home directory. From there, navigate by clicking folders, using the breadcrumb at the top, or typing a path.
Tour the toolbar
The top of the File Manager has two rows of controls.
Top row (display options)
| Control | What it does |
|---|---|
| Hidden Items (eye icon toggle) | Show or hide dotfiles like .env or .bashrc |
| Show Files (file icon toggle) | Show files (on) or only show folders (off) |
| Add Application | Open the deploy form to create a new app folder. See the Application Deployment page |
| Refresh | Reload the current folder |
Second row (navigation)
| Control | What it does |
|---|---|
| Go to Root | Jump straight to / |
| Breadcrumb path | Click any segment to jump there. The current folder is highlighted in green |
| Up arrow | Go to the parent folder. Disabled when you're already at root |
| Search | Filter the current folder by filename. "Items: N" shows the live count |
| Folder | Create a new folder in the current path |
| Upload | Pick files from your computer to upload here |
| Upload Dir | Pick a folder from your computer to upload here, including its contents |
Move around the filesystem
A few ways to get where you need to go:
- Click a folder to open it.
- Click a breadcrumb segment at the top to jump back several levels in one click.
- Click the up arrow to step up one folder.
- Click Go to Root to jump to
/.
Upload files
You have two ways to get files onto the server.
Using the Upload buttons
Open the destination folder
Browse to the folder where you want the files to land.
Click Upload (for files) or Upload Dir (for a whole folder)
A native file picker opens.
Pick what to upload
Select one or more files (or a folder) and confirm.
Wait for the progress message
You'll see "Uploading (1/3): filename.txt" as each file moves across. When done, a toast shows "Upload initiated for N item(s)" and the file list refreshes automatically.
Using drag and drop
Drag files from your computer → Drop them anywhere on the file area
While you're dragging, the file area shows an overlay that says "Drop files to upload" with an animated arrow. Let go to start the upload.
Download a file
You can download from either the card view or the list view.
| View | How |
|---|---|
| Grid (cards) | Hover over the file card, then click the Download icon in the footer |
| List (table) | Click the three-dot menu in the file's row, then choose Download |
| Right-click | Right-click the file, then choose Download from the context menu |
You'll be prompted by your browser or OS to choose where to save it.
Create a folder
Open the parent folder
Browse to where you want the new folder to live.
Click Folder
A small modal opens with a single field labelled Folder Name.
Name it and confirm
Type a name (no spaces or special characters in most server filesystems) and click the confirm button. The new folder appears immediately.
Rename or delete
Each file or folder offers the same set of actions in the grid card footer, the list row, and the right-click menu.
| Action | What it does |
|---|---|
| Rename (pencil icon) | Opens a small modal with the current name pre-filled. Edit and confirm. |
| Delete (red trash icon) | Asks "Delete <filename>? This action cannot be undone." Click OK to remove it. |
| Copy Path | Copies the full server path to your clipboard. Useful for pasting into the AI Terminal. |
Delete is permanent. Files removed here are not sent to a trash folder, they are gone for good. If the file is important, download a copy first.
Edit a text file
Use this for config files, env files, scripts, or anything else you want to tweak without leaving the app.
Open the file's menu
In list view, click the three-dot menu in the file's row. In grid view, the same option is available via right-click.
Click Edit Content
A modal opens titled Editing: filename. The full file contents load in a dark, monospaced text area.
Make your changes
Edit the text directly. The footer has three buttons:
| Button | What it does |
|---|---|
| Reload | Discard your changes and re-fetch the file from the server |
| Cancel | Close the modal without saving |
| Save | Save your changes and close the modal |
Click Save
A toast confirms "File saved successfully". If something goes wrong, you'll see "Failed to save file: ..." with the error.
For a syntax-highlighted experience on big files, you may prefer to download, edit locally, and re-upload. The built-in editor is meant for quick tweaks.
Unzip a .zip archive
Find the archive
Browse to the folder containing the .zip file. The blue Expand ZIP icon appears in the card footer for any .zip file.
Click Expand ZIP
The icon spins while the archive is being extracted. The contents land in a new folder named after the zip (without the .zip extension).
Wait for the toast
A success toast confirms "Expanded filename.zip". The file list refreshes to show the new folder.
Search and sort
- Search: type any part of a filename in the search box. Matches update live, and "Items: N" shows the count of visible files.
- Sort: folders always appear first, followed by files in alphabetical order. There is no manual sort selector.
Tips
Toggle Hidden Items on when you need to edit .env files or .bashrc. Off by default to keep the view clean.
Copy Path is your shortcut to the AI Terminal. Copy a file's path here, then paste it after cat, tail -f, or vi in the terminal.
Big folder uploads can take a while. Keep the tab open until the success toast appears, otherwise the upload may be cut short.