SSH integration | Flomation Support

00Overview

Every field below is exactly what you see in the Flomation editor. Fields marked ● live picker let you choose from a list pulled live from your account — no IDs to look up.

01Connecting SSH

Add your credentials as a Flomation environment secret, then pick them in each node. The connection fields are:

Field	Type		Details
Authentication	`string`	Required	Private Key, Passwor
SSH Private Key	`secret`	Required	Select an environment secret holding the private key
Key Passphrase	`secret`		Only if the private key is encrypted
Password	`secret`	Required
Host	`string`	Required	example.com or 10.0.0.5
Port	`integer`		22
Host Key Fingerprint	`string`		SHA256:... (optional — verifies the server's host key)
Username	`string`	Required	root

Good to know

Pick an Environment on your flow (Flow Settings → Environment) so the secret resolves. Secret fields never show the value — they reference ${secrets.your_secret}.

02Run

SSH Run Command

ssh/run · Action

Connect to a remote host over SSH and execute a command

Field	Type		Details
Command	`text`	Required	uptime
Command Timeout (seconds)	`integer`		300 (-1 for no timeout)

Returns: tool_result, stdout, stderr, exit_code

03Notes & Limitations

Behaviours and constraints worth knowing before you build with these nodes.

Each run opens its own SSH session, so a directory change or an exported variable set in one step is gone by the next — chain dependent commands into a single run with && instead of splitting them across steps.
Commands that expect an interactive terminal — password prompts, sudo without piped input, or full-screen editors — will stall the step until it times out, since no keyboard is attached to answer them.