sparkrun status

sparkrun status [options]

Show sparkrun containers running on cluster hosts. Displays containers grouped by job with their role, host, status, image, and ready-to-use logs and stop commands.

Note

sparkrun status is an alias for the underlying sparkrun cluster status command.

Options

Option	Description
--hosts / -H	Comma-separated host list
--hosts-file	File with hosts (one per line, # comments)
--cluster	Use a saved cluster by name
--json	Emit machine-readable JSON instead of the table
--dry-run / -n	Show what would be done

If no options are given, uses the default cluster.

What it shows

• Running jobs — workloads grouped by cluster ID, with role (head/worker/solo), host, status, and image
• IP mapping — when InfiniBand was detected, shows the complementary IP (management or IB) alongside each host so you can identify both addresses
• Idle hosts — hosts with no sparkrun workloads
• Pending operations — active downloads or image distributions that haven’t launched containers yet, with elapsed time. These will consume VRAM once launched
• Copy-paste commands — ready-to-use sparkrun logs and sparkrun stop commands for each job

Cross-executor since 0.3.0

Status is no longer a docker ps sweep. sparkrun asks every enabled executor that shares the cluster’s substrate and merges the answers, so a workload started by the native local executor appears alongside Docker containers — neither is visible to the other’s introspection.

A single failing executor is skipped rather than breaking the whole report, and unreachable hosts are simply absent from the output.

Examples

# Check default cluster
sparkrun status

# Check a specific cluster
sparkrun status --cluster mylab

# Check specific hosts
sparkrun status --hosts 192.168.11.13,192.168.11.14