Quick Start

Welcome to KubeMQ!
In this guide, we’ll walk you through how to install KubeMQ into your Kubernetes cluster.
Before we can do anything, we need to ensure you have access to a Kubernetes cluster running 1.12 or later, and a functioning kubectl command on your local machine. (One easy option is to run Kubernetes on your local machine. We suggest Docker Desktop or Minikube, but there are many options.)
Step 0:
Obtain KubeMQ Registration Token
1.Please visit: https://account.kubemq.io/login/register and register for a license token.
2.Wait for an email confirmation with your license token
Step 1:
Deploy KubeMQ package
First, install KubeMQ CRD components:
1
kubectl apply -f https://deploy.kubemq.io/init
Copied!
Then, install KubeMQ operator and cluster:
1
kubectl apply -f https://deploy.kubemq.io/key/<kubemq-registration-token>
Copied!
Check Your KubeMQ Cluster Installation:
1
kubectl get kubemqclusters -n kubemq
Copied!
Step 2:
Install kubemqctl CLI tool
MacOS/Linux
Windows
1
sudo curl -sL https://get.kubemq.io/install | sudo sh
Copied!
Option 1:
​Download the latest kubemqctl.exe.
Place the file under e.g. C:\Program Files\kubemqctl\kubemqctl.exe
Add that directory to your system path to access it from any command prompt
Option 2:
Run in PowerShell as administrator:
1
New-Item -ItemType Directory 'C:\Program Files\kubemqctl'
2
Invoke-WebRequest https://github.com/kubemq-io/kubemqctl/releases/download/latest/kubemqctl.exe -OutFile 'C:\Program Files\kubemqctl\kubemqctl.exe'
3
$env:Path += ';C:\Program Files\kubemqctl'
Copied!
Step 3:
Send 'Hello World'
1
kubemqctl queue send my-queue hello-world
Copied!
Get 'Hello World'
1
kubemqctl queue receive my-queue
Copied!
What's Next
Build & Deploy KubeMQ Components
Build & Deploy
​
Learn KubeMQ Basics
Channels
Smart Routing
Grouping
Learn KubeMQ Message Patterns
Queues
Pub/Sub
RPC
Get started with KubeMQ message patterns
Queues
Pub/Sub
RPC
​