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 listID NAME SLUG DOMAIN STATUS
cmqgmzzd2000001vh8eelr58s nuvera-dev nuvera-dev nuvera-dev.bucket.repost.sh activeThe SLUG column is the value you pass to -b.
repost forwarder listID NAME TYPE STATUS TARGET
YJlarNoRafppVttkDWC33 Local INTERNAL active http://localhost:5000NAME 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:
Hold delivery for an active forwarder. Reversible, and the forwarder stays configured.
Restart delivery and keep the saved rate limit. Also reactivates a disabled forwarder.
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 disableInternal 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#
| 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 |