Quick Start

In this guide, we’ll walk you through how to install KubeMQ into your Kubernetes cluster. Then, we’ll send and receive queue messages to verify your KubeMQ installation.

Please ensure you have access to a Kubernetes cluster running 1.12 or later, and a functioning kubectl command on your local machine. 


Deploy KubeMQ package

Sign up for free to KubeMQ and receive your key. 

Install KubeMQ cluster on any Kubernetes cluster.

Step 1:

kubectl apply -f https://deploy.kubemq.io/init

Step 2:

kubectl apply -f https://deploy.kubemq.io/key/{{your key}}

Pull and run KubeMQ standalone docker container:

docker run -d -p 8080:8080 -p 50000:50000 -p 9090:9090 KEY={{yourkey}} kubemq/kubemq-standalone:latest

KubeMQ standalone binaries are available for Edge locations and for local development.

Step 1: Download the latest version of KubeMQ standalone from releases

Step 2: Unpack the downloaded archive

Step 3: Run  kubemq -k {{your key}}  (A key is needed for the first time only)


Install kubemqctl cli tool

Kubemqctl is a CLI (Command Line Interface) tool to manage KubeMQ cluster.

sudo curl -sL https://get.kubemq.io/install | sudo sh
Option 1:

Download the latest kubemqctl.exe.

Place the file under e.g. C:Program Fileskubemqctlkubemqctl.exe

Add that directory to your system path to access it from any command prompt

Option 2:

Run in PowerShell as administrator:

New-Item -ItemType Directory 'C:Program Fileskubemqctl'
Invoke-WebRequest https://github.com/kubemq.io/kubemqctl/releases/download/latest/kubemqctl.exe -OutFile 'C:Program Fileskubemqctlkubemqctl.exe'
$env:Path += ';C:Program Fileskubemqctl'


Send and receive ‘hello-world’

Send ‘hello-world’

kubemqctl queue send my-queue hello-world

Get ‘hello-world’

kubemqctl queue receive my-queue


You’ve sent your first Event message using KubeMQ!

Next steps:

Check out our SDK reference and code examples .NET, GO, Java, Python, Node.js, and REST.

Read our documentation


Send a Message