Skip to main content

1. Install the CLI

Verify:

2. Sign in

Provide your personal exp_user_* API key, created from the Console settings page after you sign in through your organisation’s SSO (or set EXPANSE_API_KEY). The CLI mints and stores a local session. Confirm it worked:

3. Register a compute

A compute is anywhere expanse-daemon runs: a SLURM cluster, a Nomad cluster, or a Kubernetes cluster.
The command asks what kind of compute you’re registering and prints the install command or bootstrap snippet to run on the target. Within a minute the compute appears at console.expanse.sh.

4. Run a workload

Every workload that runs on the compute is captured automatically. No change to how anyone submits.

5. Predict and diagnose

Right-size resources before you submit:
Get solution-oriented guidance after a failure:
<execution-id> is the Expanse execution ID; find it with expanse executions or in the Console. If you only have the scheduler-native ID, pass it with --source-type:

Next steps

Architecture

How Expanse captures evidence and improves its models.

Computes

What a compute is and what’s supported.

Intelligence

How analyse and diagnose work.

CLI reference

Every command and flag.

Authentication

Personal keys and SSO.