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 token. 

Afterward, run the following command in kubectl:

kubectl apply -f https://get.kubemq.io/deploy?token=your_token_here

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