Skip to main content
File Manager
Files & TransferSourceAPIChangelog

Reference

Settings​

User​

Each person sets these for themselves in Settings.

SettingTypeDefaultWhat it does
Simultaneous File Transfersnumber4How many files the side by side local/remote manager uploads or downloads at the same time. Lower this if your server limits SFTP channels.
Confirm before moving files to trashbooleantrueAsk before moving remote files to trash. Permanent deletion still requires confirmation.
Open these file types outside TermixstringDesktop app only. File endings, like psd, jpg, pdf, that open in your external editor, or the system app when none is chosen, when you open them. Separate them with commas, or use * for every file.
Open the files panel with new terminalsbooleanfalseShow the files panel beside every SSH terminal when it opens. You can still open and close it from the button on the right edge.
Files panel sideselect"right"Where the files panel sits next to a terminal.
Files panel sizenumber380Width in pixels, or height when it is at the bottom. You can also drag its edge.
Show the panel buttonbooleantrueShow a small button on the right edge of a terminal that opens the files panel.
Follow the terminal folderbooleantrueMove the files panel to the folder your terminal is in. You can switch this off in the panel.
Folder check intervalnumber3How often, in seconds, the files panel checks which folder the terminal is in.
Folder history sizenumber20How many folders the files panel remembers for each host.

Host​

Set per host in the host editor, on the plugin's tab. Host defaults can set them for many hosts at once.

SettingTypeDefaultWhat it does
Enable File ManagerbooleantrueBrowse and edit files on this host over SFTP.
Default Pathstring
SCP Legacy Modeboolean
Show files panel in terminalsbooleantrueLet the files panel open beside this host's SSH terminal.

Permissions​

Give these to roles in Settings, Roles.

PermissionWho has it at firstWhat it allows
file-manager.useadmin, userBrowse, edit and transfer files over SFTP.

Actions​

Run these from Operations Center, Automations, the CLI (termix ops), the phone app or the API. See actions.

ActionRuns onRiskInputs
file-manager.list-files
List files
A hostRead onlypath
file-manager.path-info
File info
A hostRead onlypath
file-manager.make-folder
Make folder
A hostChangespath
file-manager.delete-path
Delete file or empty folder
A hostDestructivepath

Capabilities​

What the plugin's code is allowed to do. Termix shows this list before you install it. See capabilities for all of them.

CapabilityRiskWhat it means
credentials:readCriticalSee your passwords and keys. It can read the stored secret for any host you can reach.
ssh:connectHighRun commands on your servers. Any command, on hosts you connect it to, with your access.
users:impersonateHighAct as other users. Runs background work with another user's access, such as scheduled jobs. Every use is written to the audit log.
desktop:localHighUse this computer. Can read and change files, run a shell and open local ports on this computer. Only in the Termix desktop app.
network:socketsHighOpen its own network connections. It can listen on ports and connect to any address directly, without Termix checking each connection.
credentials:useMediumConnect to your servers. It cannot see your passwords or keys.
network:serveMediumAccept connections. It opens a port on the Termix server.
events:coreMediumWatch everything happening. Including activity from other users, not just yours.
operations:provideMediumOffer actions. Its actions can be run from Automations, the CLI, the phone app and other places, by people allowed to use them.
hosts:readLowSee your host list. Names and addresses for hosts you can already see.
db:ownLowStore its own data. Kept in its own tables, separate from other plugins.
ui:surfaceLowAdd its own screens. Tabs, panels and settings you can hide later.
kv:ownLowRemember small settings. Kept separate from other plugins.
files:ownLowStore its own files. In its own folder on disk, separate from other plugins.

Services​

Services are how plugins call each other. Plugin authors can use these.

ProvidesVersionPermission
files.sftp1.0.0file-manager.use

API​

The plugin's HTTP routes are in the API reference.

Platforms​

Linux, Windows, macOS