---
sidebar_position: 12
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# `lium ps`

List your active pods.

```bash
lium ps [POD_ID] [OPTIONS]
```

## Arguments

- `POD_ID` — Optional pod name, index, or id. When given, shows just that pod.

## Options

| Flag | Effect |
|------|--------|
| `--format FORMAT` | Output format: `table` (default) or `json` |

## Examples

```bash
lium ps                   # All your pods
lium ps my-pod            # A single pod by name/index/id
lium ps --format json     # JSON output
```

Naming a `POD_ID` that matches nothing exits `5`, in both `table` and `json`
format — the same rule [`lium rm`](./rm) follows. An unfiltered `lium ps` on an
account with no pods is not a failure: it warns `No active pods` as a table,
prints `[]` with `--format json`, and exits `0` either way.

The numeric index in the first column is reused by [`lium ssh`](./ssh), [`lium exec`](./exec), [`lium scp`](./scp), [`lium rsync`](./rsync), and [`lium rm`](./rm).

## See also

- [`lium up`](./up) — create a pod
- [`lium rm`](./rm) — stop a pod