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. 

Afterwards, run the following command in kubectl:

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

Check Your KubeMQ Cluster Installation:

kubectl get kubemqclusters -n kubemq


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 and REST.

Read our documentation

Send a Message