ssh
Execute commands on remote servers via SSH with password or key authentication. Supports session pooling, ProxyJump, and configurable host key verification.
Instructions
Execute commands on a remote server via SSH. Supports password and key-based authentication. SSH agent is used as fallback on Unix. Sessions are automatically pooled and reused for the same host:port:user combination. Idle sessions expire after 10 minutes. Supports IPv6 addresses and ProxyJump (jump_host) for reaching servers through bastion hosts.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | SSH server hostname or IP address (IPv4 or IPv6),required | |
| port | No | SSH port number. Default: 22 | |
| user | Yes | SSH username,required | |
| password | No | Password for authentication | |
| key_file | No | Path to SSH private key file (e.g. ~/.ssh/id_rsa) | |
| passphrase | No | Passphrase for encrypted private key | |
| use_agent | No | Use SSH agent for authentication: true or false. Default: true if no other auth method specified | |
| command | No | Command to execute on the remote server | |
| disconnect | No | Close the SSH session for this host (no command needed): true or false. Default: false | |
| host_key_check | No | Host key verification: strict (requires known_hosts), tofu (trust on first use, default), none (insecure) | |
| timeout_sec | No | Command execution timeout in seconds. Default: 30, Max: 300 | |
| jump_host | No | Jump/bastion host for ProxyJump (hostname or IP). When set, connects through this host to reach the target | |
| jump_port | No | Jump host SSH port. Default: 22 | |
| jump_user | No | Jump host username. Default: same as user | |
| jump_password | No | Jump host password. Default: same as password | |
| jump_key_file | No | Jump host SSH private key file. Default: same as key_file | |
| jump_passphrase | No | Jump host key passphrase. Default: same as passphrase |