Link Search Menu Expand Document Edit GitHub


Disconnects a previously connected client.

mqtt> disconnect

Alias: mqtt> dis

Disconnects the currently active client context.

client@host> disconnect

Alias: client@host> dis


OptionLong VersionExplanationDefault
-a--allDisconnect all connected clients. 
-i--identifierThe unique identifier of a client. 
-h--hostThe host the client is connected to.localhost
-e--sessionExpirySession expiry value in seconds.0 (No Expiry)
-r--reasonReason string for the disconnect. 
-up--userPropertyA user property of the disconnect message. 

Help Options

OptionLong VersionExplanation
 --helpDisplay help message for command.
 --versionDisplay version information of the cli.


Connect a client which is identified by myClient and disconnect it afterward using default settings

mqtt> con -i myClient
myClient@localhost> dis

Connect a client which is identified by myClient on specific settings and disconnect it afterward

mqtt> con -i myClient -h
myClient@localhost> exit  # client is still connected
mqtt> dis -i myClient -h

NOTE: When specifying the identifier in order to uniquely identify the desired client, the hostname must also be provided. If you don’t specify these the default settings for these attributes will be used which may lead to unexpected behavior.