---
description: Reference the KumoMTA command-line utilities in /opt/kumomta/sbin, including validate-shaping, resolve-shaping-domain, traffic-gen, tailer, and more.
---

# Supporting utilities

KumoMTA comes with several utilities that are useful for debugging or supporting KumoMTA.  These are located in `/opt/kumomta/sbin/`.

# Utilities list

* validate-shaping - Used for validating the syntax of your custom shaping files. Using this tool is as simple as providing the shaping file to the utility on the command line. For example: `/opt/kumomta/sbin/validate-shaping /opt/kumomta/etc/policy/custom-shaping.toml`
* resolve-shaping-domain - Used for identifying which traffic shaping rules will be applied to a given destination domain. For example: `/opt/kumomta/sbin/resolve-shaping-domain mosaicco.com`
* tsa-daemon - The TSA Daemon is a tool that can provide centralized traffic shaping data for your entire cluster even across data centers, providing the KumoMTA nodes can connect to it over TCP. This is typically launched from KumoMTA directives as documented [here](../trafficshaping/automation.md#configure-the-tsa_initlua-file)
* traffic-gen - TrafficGen is a handy performance testing tool that uses core KumoMTA speed to generate high-volume injection testing SMTP messages. Usage instructions are available with `/opt/kumomta/sbin/traffic-gen --help`
* tailer - Tailer provides a flexible command line tool for tracing log activity in real time without having to `tail -f` the actual logs. It allows you to filter for specific patterns or evaluate a specific batch size of log lines. Usage instructions are available with `/opt/kumomta/sbin/tailer --help`  More details can be found [here](./logs.md#using-tailer).
* proxy-server - KumoProxy is a functional SOCKS5 proxy server that can run independently from KumoMTA.  Usage instructions are available with `/opt/kumomta/sbin/proxy-server --help`
* accounting.sh - a helpful tool to show volumes of messages sent and received in a calendar month.  This can be helpful for your own purposes in tracking monthly and annual volume.             
* toml2jsonc - As implied by the name, will convert a TOML file to JSON.
* explain-throttle - explains how a throttle is interpreted by KumoMTA
* resolve-queue-config  - similar to `resolve-shaping-domain` but will show queue settings for that particular domain or MX
* resolve-site-name - provides the result of how KumoMTA sees the MX-Rollup for the target domain.  For instance `/opt/kumomta/sbin/resolve-site-name kumomta.com` results in `smtp.google.com`
* tls-probe can be used in two ways.  With the `probe` option, it can test if an MX supports STARTTLS. With the `list-rustls-cipher-suites` option, it will show all cipher suites supported by rustls.
* kcli - KumoMTA Command Line Interface (KCLI) is a useful tool for accessing the HTTP API directly from the command line. Usage instructions are available with `/opt/kumomta/sbin/kcli --help`  More details can be found [here](./kcli.md).
* kumod - this is the actual KumoMTA daemon and is just listed here for completeness.
