---
title: sparkrun status
description: Check the status of running inference workloads.
---

```bash
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 |
| `--dry-run` / `-n` | Show what would be done |

If no options are given, uses the default cluster.

## What it shows

- **Running jobs** — containers 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 containers
- **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

## Examples

```bash
# 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
```
