Skip to content

MQTT Messaging

MQTT Messaging configuration allows you to specify settings for the MQTT protocol used by your NanoMQ broker.

Example Configuration

mqtt = {
  max_packet_size = 1KB       # Maximum packet size NanoMQ can accept and send, 1B~260MB.
  max_mqueue_len = 2048       # Maximum length of the in-flight window queue
  retry_interval = 10s        # Retry interval for QoS 1/2 message delivering
  keepalive_multiplier = 1.25 # Multiplier for MQTT keepalive timeout. 
  property_size = 32          # Maximum size for a MQTT user property.

Configuration Items

Configuration ItemDescriptionValue Range
max_packet_sizeSpecifies the maximum size of a packet that NanoMQ can accept and send1 Byte to 260 MB
max_mqueue_lenSpecifies the maximum length of the in-flight window queue.

Note: This item may affect the system performance and memory consumption, please set it with caution.
1 ~ infinity
retry_intervalSpecifies the retry interval for QoS 1/2 message delivering1 ~ infinity
keepalive_multiplierSpecifies the multiplier for the MQTT keepalive timeout. The broker will disconnect the client if there's no activity for Keepalive * backoff time.Float > 0.5
property_sizeSpecifies the maximum size for an MQTT user property.1 ~ infinity


All of these MQTT configurations in NanoMQ support hot upgrading. This means that any changes made to these settings will take effect immediately after you save the configuration file, without the need to restart the NanoMQ broker.

Upcoming Features

More configuration items will be supported in upcoming releases, please stay tuned.

  • max_inflight_window
  • max_awaiting_rel
  • await_rel_timeout