Nexterm includes a full SFTP file manager that you can open alongside any SSH server session. The file manager lets you navigate the remote filesystem, transfer files in both directions, and perform common file operations — all without leaving the browser.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/gnmyt/Nexterm/llms.txt
Use this file to discover all available pages before exploring further.
How SFTP works in Nexterm
The file manager communicates with the remote host over the same SSH connection used by your terminal session, using the SFTP subsystem. A WebSocket connection carries binary-framed operation messages between the browser and the Nexterm server, which in turn issues SFTP commands against the host.SFTP is available only for SSH entries. RDP, VNC, Telnet, and Proxmox entry types do not expose the file manager.
Opening the file manager
Connect to an SSH server
Open a terminal session for any SSH entry in the sidebar by clicking on it.
Open the file manager panel
Click the Files icon in the session toolbar (or use the keyboard shortcut if one is configured). The file manager opens in a side panel or a dedicated tab, depending on your layout.
Navigating directories
- Click a folder name to navigate into it.
- Click the parent directory arrow (
..) or the breadcrumb path at the top of the panel to go up. - Use the search field to search for directories matching a pattern, powered by the
SEARCH_DIRECTORIESoperation. - Symlinks are displayed in the file list. You can resolve a symlink to its real path using the Resolve symlink action.
Uploading files
Navigate to the destination directory
Use the directory browser to go to the folder where you want to upload.
Choose files
Click Upload and select one or more files from your local machine, or drag and drop files directly onto the file list.
Downloading files
Single file or folder
Right-click a file and choose Download, or select it and click the Download button in the toolbar.- Files are streamed directly to your browser with the correct
Content-Dispositionheader. - Folders are automatically packaged as a ZIP archive (using zlib compression level 1 for speed) and downloaded as
<folder-name>.zip.
| Extension | MIME type |
|---|---|
pdf | application/pdf |
jpg, jpeg | image/jpeg |
png | image/png |
gif | image/gif |
webp | image/webp |
svg | image/svg+xml |
mp4 | video/mp4 |
webm | video/webm |
mp3 | audio/mpeg |
txt | text/plain |
json | application/json |
html | text/html |
css | text/css |
js | application/javascript |
Image thumbnails
For image files (JPG, JPEG, PNG, GIF, WebP, BMP) that are 10 MB or smaller, Nexterm can generate a thumbnail preview. Thumbnails are resized to a square crop between 50 and 300 pixels (default 100 px) and cached by the browser for one hour.Multiple files and folders
Select multiple items using the checkboxes, then click Download selected. Nexterm packages everything into a single ZIP archive namednexterm-download-<timestamp>.zip. Items that cannot be read are silently skipped and logged on the server.
File operations
Create file
Create file
Click New file, enter a name, and confirm. An empty file is created at the current path.
Create folder
Create folder
Click New folder, enter a name, and confirm. The directory is created with
mkdir.Rename
Rename
Right-click a file or folder and choose Rename. Enter the new name and confirm. The operation uses SFTP rename, which also functions as a move within the same filesystem.
Delete file
Delete file
Right-click a file and choose Delete. The file is removed with
unlink. This action cannot be undone.Delete folder
Delete folder
Right-click a folder and choose Delete. The folder is removed recursively. This action cannot be undone.
Move files
Move files
Select one or more items, choose Move, and pick a destination directory. Each item is renamed to
<destination>/<filename>.Copy files
Copy files
Select one or more items, choose Copy, and pick a destination directory. Nexterm runs
cp -r on the remote host to perform the copy. If the remote shell returns a non-zero exit code, an error is shown.Change permissions (chmod)
Change permissions (chmod)
Right-click a file or folder and choose Permissions. Enter the numeric mode (e.g.,
755) and confirm. The change is applied with SFTP chmod.File info (stat)
File info (stat)
Right-click an item and choose Properties to view size, permissions, owner, and timestamps via SFTP
stat.Checksum
Checksum
Right-click a file and choose Checksum. Select an algorithm —
md5, sha1, sha256, or sha512 — and Nexterm runs the corresponding checksum command (md5sum, sha1sum, sha256sum, sha512sum) on the remote host and displays the result.Folder size
Folder size
Right-click a folder and choose Get size. Nexterm runs
du -sb on the remote host and displays the total size in bytes.Audit logging
Every file operation performed through the SFTP file manager is recorded in the audit log:| Action | Logged event |
|---|---|
| Upload | FILE_UPLOAD with path and size |
| Download (file) | FILE_DOWNLOAD with path and size |
| Download (folder) | FOLDER_DOWNLOAD with folder path |
| Create file | FILE_CREATE |
| Create folder | FOLDER_CREATE |
| Delete file | FILE_DELETE |
| Delete folder | FOLDER_DELETE |
| Rename / move | FILE_RENAME with old and new paths |
| Chmod | FILE_CHMOD with path and octal mode |