truss ssh

truss ssh [COMMAND] [OPTIONS]

Configures SSH access to Baseten workloads: training jobs and model replicas. For training usage, see SSH access. For models, enable runtime.remote_ssh in your Truss config.

Subcommands

setup

Configures OpenSSH on your machine to authenticate with Baseten and connect to workloads. Run this once per machine.

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 workload:

# Training job, per node
ssh training-job-<job_id>-<node>.ssh.baseten.co

# Model deployment (requires runtime.remote_ssh.enabled in the Truss config)
ssh model-<model_id>-<deployment_id>.ssh.baseten.co

# Specific replica of a model deployment
ssh model-<model_id>-<deployment_id>-<replica_id>.ssh.baseten.co

Options

TEXT

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.

TEXT

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.

humanfriendly | W | WARNING | I | INFO | D | DEBUG

default:"humanfriendly"

Logging verbosity. humanfriendly (default) is pretty-printed; INFO, DEBUG, WARNING produce structured logs.

Disable interactive prompts. Use in CI/automated contexts where stdin isn’t a TTY.

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

Reference

Inference API

Management API

CLI reference

SDK reference

Training API

Frontier Gateway API

CI/CD

Subcommands

setup

Options

Examples

​Subcommands

​setup

​Options

​Examples

Subcommands

setup

Options

Examples