Skip to content

Interface: SshSessionOptions

Connection, key, host-verification, and command settings for one SSH machine.

connectTimeoutMs: number

Connection timeout in milliseconds.


host: string

Databricks Sandbox gateway hostname.


optional knownHost?: string

Previously trusted SHA-256 host-key fingerprint.


knownHostsPath: string

Dedicated OpenSSH known-host file for this workspace, user, and gateway.


port: number

SSH gateway port.


privateKey: string

In-memory private key used by ssh2 forwarding.


privateKeyPath: string

Private key file used by native OpenSSH commands.


optional rememberHost?: (fingerprint, key) => Promise<void>

Persists the first accepted host key after a successful connection.

string

Buffer

Promise<void>


optional resolvePublicAddresses?: (host) => Promise<string[]>

Resolves public fallback addresses for a service-direct gateway.

string

Promise<string[]>


optional sshCommand?: string

Native OpenSSH executable. Defaults to ssh.


username: string

SSH username accepted by the Sandbox gateway.