MOSQUITTO_CTRL(1) Commands MOSQUITTO_CTRL(1) (NAME) mosquitto_ctrl_shell - Mosquitto (SYNOPSIS) mosquitto_ctrl [-h hostname] [-p port-number] [-u username] [-P password] [-i client-id] [--cafile file] [--capath dir] [--cert file --key file] (DESCRIPTION) mosquitto_ctrl Mosquitto . . mosquitto_ctrl(1) . . mosquitto_ctrl . (prompt) . (ENCRYPTED CONNECTIONS) mosquitto_ctrl TLS . mosquitto_ctrl . TLS (scheme) mqtts:// wss:// mosquitto_ctrl --cafile --capath - CA . . --cert --key . (EXAMPLE SHELL WORKFLOW) 1. (mode) . dynamic-security: $ mosquitto_ctrl mosquitto_ctrl shell v2.1.0 > auth username: admin password: > connect mqtt://localhost mqtt://localhost:1883> dynsec mqtt://localhost:1883|dynsec> createGroup newgroup OK . (tab completion) . . . . help . : help createGroup. : Pre-connection broker . Post-connection mosquitto_ctrl broker . dynsec ACL . broker listener (plugins) . (AUTHENTICATION) mosquitto_ctrl x509 . . . -u -P . auth . . auth . auth username . (CONNECTION) broker connect . o broker localhost 1883. > connect o broker 1883. > connect mqtt://test.mosquitto.org o broker 1884. > connect mqtt://test.mosquitto.org:1884 o broker TLS. > connect mqtts://test.mosquitto.org o broker websockets. > connect ws://test.mosquitto.org o broker websockets TLS. > connect wss://test.mosquitto.org -h . (DYNAMIC-SECURITY MODE) dynsec . dynamic-security . ACL . Tab . Tab . help . return exit . (BROKER MODE) broker . enable_control_api true . listListeners listPlugins . return exit . (CONNECTION OPTIONS) : --cafile CA PEM . SSL . : --capath --capath CA PEM . SSL . --capath <<.crt>> <>> . : --cafile --cert PEM . : --key Encrypted Connections. --ciphers openssl TLS . ciphers(1) . --help . -h, --host . localhost . -i, --id . MQTT . v3.1.1/v3.1 mosq-XXXXXXXXXXXXXXXXXX X - . v5.0 . --key PEM TLS . : --cert Encrypted Connections. -p, --port . 1883 MQTT 8883 MQTT TLS . -u, --username . --pw . mosquitto_ctrl . (BUGS) mosquitto : https://github.com/eclipse-mosquitto/mosquitto/issues (SEE ALSO) mosquitto(7), mqtt(7), mosquitto_ctrl(1), mosquitto_rr(1), mosquitto_pub(1), mosquitto_sub(1), mosquitto(8), libmosquitto(3), mosquitto-tls(7) (AUTHORS) Roger Light Mosquitto Project 04/03/2026 MOSQUITTO_CTRL(1)