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

# Manage forwarders

> List buckets and forwarders, check their status, and pause, resume, or disable delivery from the terminal.

Manage delivery from the terminal — find your buckets and forwarders, then pause, resume, or disable one without opening the dashboard. For the dashboard equivalent, see [forwarder configuration](/docs/forwarders/configuration#forwarder-lifecycle).

## Find buckets and forwarders

The management commands take a **bucket slug** and a **forwarder name**. List them first.

```bash theme={"languages":{"custom":["/languages/repost.json"]}}
repost bucket list
```

```text Output theme={"languages":{"custom":["/languages/repost.json"]}}
ID                         NAME        SLUG        DOMAIN                       STATUS
cmqgmzzd2000001vh8eelr58s  nuvera-dev  nuvera-dev  nuvera-dev.bucket.repost.sh  active
```

The `SLUG` column is the value you pass to `-b`.

```bash theme={"languages":{"custom":["/languages/repost.json"]}}
repost forwarder list
```

```text Output theme={"languages":{"custom":["/languages/repost.json"]}}
ID                     NAME   TYPE      STATUS  TARGET
YJlarNoRafppVttkDWC33  Local  INTERNAL  active  http://localhost:5000
```

`NAME` is what you pass to `-f`, and `STATUS` is `active`, `paused`, or `inactive`. Without `--bucket`, forwarders from every accessible bucket are listed; add `--bucket <slug>` to scope the list to one bucket.

## Pause, resume, or disable

Three actions control whether a forwarder delivers:

<Columns cols={3} className="gap-y-4">
  <Card title="Pause" icon="pause">
    Hold delivery for an active forwarder. Reversible, and the forwarder stays configured.
  </Card>

  <Card title="Resume" icon="play">
    Restart delivery and keep the saved rate limit. Also reactivates a disabled forwarder.
  </Card>

  <Card title="Disable" icon="ban">
    Turn a forwarder off until it is explicitly resumed.
  </Card>
</Columns>

Run any of them without flags for an interactive selector, or pass a bucket slug and one or more forwarder names to target them directly.

<Tabs>
  <Tab title="Interactive" icon="mouse-pointer-click">
    ```bash theme={"languages":{"custom":["/languages/repost.json"]}}
    repost forwarder pause
    repost forwarder resume
    repost forwarder disable
    ```
  </Tab>

  <Tab title="Scripted" icon="square-terminal">
    ```bash theme={"languages":{"custom":["/languages/repost.json"]}}
    repost forwarder pause -b stripe-prod -f prod-api
    repost forwarder resume -b stripe-prod -f prod-api
    ```
  </Tab>
</Tabs>

<Note>
  **Internal vs external.** External forwarders are delivered by Repost and can be paused at any time — this is the one to pause around a deploy. Internal forwarders are driven by a connected CLI session; in the dashboard, their pause control appears only while a `repost forward` listener is connected.
</Note>

While a forwarder is paused, the bucket keeps recording incoming requests in event history, so nothing is lost. Redeliver anything that arrived during the pause with [history replay](/docs/history/replay).

## Shortcuts

| Shortcut    | Command                    |
| ----------- | -------------------------- |
| `repost bl` | `repost bucket list`       |
| `repost fl` | `repost forwarder list`    |
| `repost fp` | `repost forwarder pause`   |
| `repost fr` | `repost forwarder resume`  |
| `repost fd` | `repost forwarder disable` |

## Next

<Columns cols={3} className="gap-y-4">
  <Card title="Pause in CI" icon="workflow" href="/docs/cli/ci-automation" cta="Automate" arrow="true">
    Pause and resume a forwarder around a deploy in a GitHub Actions pipeline.
  </Card>

  <Card title="Dashboard lifecycle" icon="route" href="/docs/forwarders/configuration" cta="Configuration" arrow="true">
    The active, paused, disconnected, and deleted lifecycle in the dashboard.
  </Card>

  <Card title="Command reference" icon="list-tree" href="/docs/cli/reference" cta="Reference" arrow="true">
    Full flags, output columns, and shortcuts for every command.
  </Card>
</Columns>