SFTP File Browser

The FILES tab provides a full SFTP file browser over your SSH connection — no separate SFTP client needed.

Opening Files

Click the FILES tab on a connected server. The browser opens at the server's home directory for the connected user.

:::note Same connection Files uses the same authenticated SSH session as the terminal — no second login required. :::

Navigating

• Single-click a folder to open it
• Click the breadcrumb trail at the top to jump up the tree
• ↑ UP button to go to the parent directory
• Type a path directly in the address bar and press Enter

Uploading Files

Drag & Drop

Drag files or folders from your local machine into the file browser. A progress bar shows transfer status for each file.

Upload Button

Click the ↑ UPLOAD button in the toolbar → select files from your local file system.

Large files are transferred in chunks — the UI remains responsive during upload.

Downloading Files

• Right-click a file → Download — saves to your browser's default download location
• Right-click a folder → Download as .zip — compresses server-side, then downloads

File Operations

Right-click any file or folder for the context menu:

Action	Description
Open in terminal	cd to this path in the TERM tab
Rename	Rename the file inline
Delete	Permanently delete — shows confirmation
Copy path	Copy the absolute path to clipboard
Change permissions	Edit Unix permissions (octal or toggle)
Download	Download to local machine

Creating Files & Folders

• New folder: click + NEW FOLDER in the toolbar → type name → Enter
• New file: click + NEW FILE → type filename → opens an inline text editor

Inline File Editor

Click a text file to open it in the inline editor. Supports syntax highlighting for common formats (.sh, .conf, .json, .yaml, .env).

• Save: Ctrl+S / Cmd+S — writes directly to the server
• Close without saving: click × — prompts if there are unsaved changes

:::caution Binary files Binary files (images, executables, databases) open in a hex preview. The editor does not support binary editing — download instead. :::

Permissions

Change permissions via right-click → Change permissions:

• Toggle read/write/execute per owner/group/other
• Or enter an octal value directly (e.g. 644, 755, 600)
• Applies chmod on the server immediately

Hidden Files

Click the eye icon in the toolbar to toggle visibility of hidden files (dotfiles and ./.. entries).

Limitations

• Max single-file upload: limited by available memory and SFTP chunk size — practical limit ~2 GB
• Symlinks are shown but not followed for uploads
• SFTP must be enabled on the server (Subsystem sftp /usr/lib/openssh/sftp-server in sshd_config)