# Command-Line Help for `kcli`

This document contains the help content for the `kcli` command-line program.

## `kcli`

KumoMTA CLI.

Interacts with a KumoMTA instance via its HTTP API endpoint. To use it, you must be running an HTTP listener.

The default is to assume that KumoMTA is running a listener at http://127.0.0.1:8000 (which is in the default configuration), but otherwise you can override this either via the --endpoint parameter or KUMO_KCLI_ENDPOINT environment variable.

Full docs available at: <https://docs.kumomta.com>


**Usage:** `kcli [OPTIONS] <COMMAND>`

###### **Subcommands:**


* `bounce` — Administratively bounce messages in matching queues

* `bounce-list` — Returns list of current administrative bounce rules

* `bounce-cancel` — Cancels an admin bounce entry

* `rebind` — Rebind messages from matching queues into different queue(s)

* `spool-compact` — Forces a flush and full compaction of the named spool

* `suspend` — Administratively suspend messages in matching queues

* `suspend-list` — Returns list of current administrative suspend rules

* `suspend-cancel` — Cancels an admin suspend entry

* `suspend-ready-q` — Administratively suspend the ready queue for an egress path

* `suspend-ready-q-list` — Returns list of current ready queue/egress path suspend rules

* `suspend-ready-q-cancel` — Cancels an admin suspend entry for a ready queue/egress path

* `set-log-filter` — Changes the diagnostic log filter

* `abort-ready-q-conn` — Aborts the dispatcher task within a ready queue identified by its session_id. The dispatcher's drop path returns any in-flight message to the scheduled queue for another delivery attempt

* `inspect-message` — Returns information about a message in the spool

* `inspect-ready-q` — Returns information about a ready queue: its egress identity, effective state (throttles, suspensions, ready and connection counts), and, optionally, the dispatcher tasks that are currently handling its connections plus the egress path configuration in effect

* `inspect-sched-q` — Returns information about a scheduled queue

* `resolve-egress-path` — Resolve the effective egress path configuration and throughput ceilings for a destination domain and egress source

* `provider-summary` — Prints a summary of the aggregate state of the queues from the perspective of the provider or destination site

* `queue-summary` — Prints a summary of the state of the queues, for a human to read

* `trace-smtp-client` — Trace outgoing sessions made by the SMTP service

* `trace-smtp-server` — Trace incoming connections made to the SMTP service

* `top` — Continually update and show what's happening in kumod

* `xfer` — Transfer messages from matching queues to an alternative kumomta node

* `xfer-cancel` — Cancels a message transfer that was initiated via the xfer subcommand.  You specify the name of the xfer queue associated with the transfer and matching messages will be taken out of that queue and returned to their originating queue

## Options


* `--endpoint <ENDPOINT>` — URL to reach the KumoMTA HTTP API. You may set KUMO_KCLI_ENDPOINT in the environment to specify this without explicitly using --endpoint. If not specified, http://127.0.0.1:8000 will be assumed





## Available Subcommands { data-search-exclude }