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. 
repost bucket list
Output
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. 
repost forwarder list
Output
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 <id> 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. 
repost forwarder pause
repost forwarder resume
repost forwarder disable
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

ShortcutCommand
repost blrepost bucket list
repost flrepost forwarder list
repost fprepost forwarder pause
repost frrepost forwarder resume
repost fdrepost forwarder disable

​
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.