Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.baseten.co/llms.txt

Use this file to discover all available pages before exploring further.

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

​
--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