Skip to main content
truss ssh [COMMAND] [OPTIONS]
Configures SSH access to Baseten training jobs. See SSH access for usage and examples.

Subcommands

setup

One-time setup that configures OpenSSH on your machine to authenticate with Baseten and connect to training jobs.
truss ssh setup [OPTIONS]
Generates an SSH keypair, installs a ProxyCommand script, and adds a wildcard Host entry to ~/.ssh/config. After running this once, connect to any running training job with:
ssh training-job-<job_id>-<node>.ssh.baseten.co

Options

--python
string
Path to a Python 3.10+ interpreter for the ProxyCommand. Auto-detected if omitted. Use this if you see TLS errors with the default Python.
--default-remote
string
Default remote to use when the hostname doesn’t specify one and ~/.trussrc has multiple remotes. If you have a single remote, Baseten uses it automatically.
--log
[humanfriendly|w|warning|i|info|d|debug]
Customize logging verbosity.
--non-interactive
Disable interactive prompts. Use in CI or automated execution contexts.

Examples

Run one-time setup:
truss ssh setup
If you see TLS errors, specify a newer Python:
truss ssh setup --python /opt/homebrew/bin/python3.13
Set a default remote when multiple are configured:
truss ssh setup --default-remote baseten-dev