Skip to main content

​
create

Create an SSH workstation: a training job that holds GPUs for an interactive session instead of running a training script. Pass —node-count for a multi-node workstation, where each node has eight GPUs and SLURM is set up across them. Connect once the job is running.

​
Options

​
TEXT
default:"H100"
GPU accelerator type.
​
TEXT
Training job whose latest checkpoint the workstation starts from.
​
TEXT
Path inside the container where checkpoints are written.
​
INTEGER
Size of the checkpoint volume in GiB.
​
BOOL
Attach checkpoint storage to the workstation.
​
INTEGER
Number of GPUs on a single node, 1 to 8. Mutually exclusive with —node-count.
​
TEXT
Docker base image the workstation runs.
​
TEXT
Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)
​
INTEGER
Number of eight-GPU nodes, 1 to 16. Mutually exclusive with —gpu-count.
​
TEXT
default:"slurm"
Multi-node orchestrator set up across the nodes.One of: slurm
​
TEXT
default:"text"
Output formatOne of: text, json, jsonl, none
​
TEXT
Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile
​
TEXT
Training project that owns the workstation. Defaults to ‘workstation-accelerator’.
​
TEXT
Team name or ID that owns the training project.
​
TEXT
Run this truss executable instead of fetching one with uv, e.g. a virtualenv’s bin/truss. A value with no path separator is looked up on PATH, so ‘—truss-executable truss’ runs the truss you installed. Defaults to BASETEN_TRUSS_EXECUTABLE.
​
BOOL
Do not forward this CLI’s credentials to truss, leaving it to resolve a remote from your trussrc. Old truss versions ignore forwarded credentials and use the trussrc regardless.
​
TEXT
Version of truss to fetch and run with ‘uv tool run’, e.g. 0.18.26. Defaults to BASETEN_TRUSS_VERSION, or the latest release. Mutually exclusive with —truss-executable.
​
BOOL
Enable verbose logging

​
Examples

Create a single-GPU workstation
Create a four-node workstation with checkpoint storage

​
Output

Text mode (--output text): A confirmation that the workstation was created, with the ssh host of each node and the commands to view its logs or stop it. JSON mode (--output json): payload type cmd.TrussDelegatedResult. Under —output json the text output goes to stderr and stdout is an empty object: this command reports nothing structured yet.