KubeMQ binding spec

Detailed documentation on the KubeMQ binding component

Component format

To setup KubeMQ binding create a component of type bindings.kubemq. See this guide on how to create and apply a binding configuration.

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: binding-topic
spec:
  type: bindings.kubemq
  version: v1
  metadata:
    - name: address
      value: "localhost:50000"
    - name: channel
      value: "queue1"
    - name: direction
      value: "input, output"

Spec metadata fields

FieldRequiredDetailsExample
addressYAddress of the KubeMQ server"localhost:50000"
channelYThe Queue channel name"queue1"
authTokenNAuth JWT token for connection. Check out KubeMQ Authentication"ew..."
autoAcknowledgedNSets if received queue message is automatically acknowledged"true" or "false" (default is "false")
pollMaxItemsNSets the number of messages to poll on every connection"1"
pollTimeoutSecondsNSets the time in seconds for each poll interval"3600"
directionNThe direction of the binding"input", "output", "input, output"

Binding support

This component supports both input and output binding interfaces.

Create a KubeMQ broker


  1. Obtain KubeMQ Key.
  2. Wait for an email confirmation with your Key

You can run a KubeMQ broker with Docker:

docker run -d -p 8080:8080 -p 50000:50000 -p 9090:9090 -e KUBEMQ_TOKEN=<your-key> kubemq/kubemq

You can then interact with the server using the client port: localhost:50000


  1. Obtain KubeMQ Key.
  2. Wait for an email confirmation with your Key

Then Run the following kubectl commands:

kubectl apply -f https://deploy.kubemq.io/init
kubectl apply -f https://deploy.kubemq.io/key/<your-key>

Install KubeMQ CLI

Go to KubeMQ CLI and download the latest version of the CLI.

Browse KubeMQ Dashboard


Open a browser and navigate to http://localhost:8080


With KubeMQCTL installed, run the following command:

kubemqctl get dashboard

Or, with kubectl installed, run port-forward command:

kubectl port-forward svc/kubemq-cluster-api -n kubemq 8080:8080

KubeMQ Documentation

Visit KubeMQ Documentation for more information.


Last modified November 21, 2023: v1.11 fix links (#3877) (d68b3bca)