Skip to main content
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.

​
Find buckets and forwarders

The management commands take a bucket slug and a forwarder name. List them first.
Output
The SLUG column is the value you pass to -b.
Output
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:

Pause

Hold delivery for an active forwarder. Reversible, and the forwarder stays configured.

Resume

Restart delivery and keep the saved rate limit. Also reactivates a disabled forwarder.

Disable

Turn a forwarder off until it is explicitly resumed.
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.
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.
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.

​
Shortcuts

​
Next

Pause in CI

Pause and resume a forwarder around a deploy in a GitHub Actions pipeline.

Dashboard lifecycle

The active, paused, disconnected, and deleted lifecycle in the dashboard.

Command reference

Full flags, output columns, and shortcuts for every command.