KubeMQ Docs
KubeMQ.ioLogin / Register
Search…
Introduction
What's New
Getting Started
Quick Start
Build & Deploy
Create Cluster
Create Dashboard
Create Connector
Message Patterns
Learn
The Basics
Message Patterns
Access Control
Clustering
Dashboard
Connectors
Configuration
Cluster
Dashboard
Connectors
HOW TO
Connect Your Cluster
Show Dashboard
Get Cluster Status
Get Dashboard Status
Get Cluster Logs
Development
SDK
Cookbook
Troubleshooting
Start Here
Kubemqctl
Get Started
Create
Get
Delete
Set
Scale Cluster
Queues
Events
Events Store
Commands
Queries
Config
License
Open Source Software Notices
Powered By GitBook
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. 1.
    Please visit: https://account.kubemq.io/login/register and register for a license token.
  2. 2.
    Wait for an email confirmation with your license token

Step 1:

Deploy KubeMQ package

First, install KubeMQ CRD components:
kubectl apply -f https://deploy.kubemq.io/init
Then, install KubeMQ operator and cluster:
kubectl apply -f https://deploy.kubemq.io/key/<kubemq-registration-token>

Check Your KubeMQ Cluster Installation:

kubectl get kubemqclusters -n kubemq

Step 2:

Install kubemqctl CLI tool

MacOS/Linux
Windows
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 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:
New-Item -ItemType Directory 'C:\Program Files\kubemqctl'
Invoke-WebRequest https://github.com/kubemq-io/kubemqctl/releases/download/latest/kubemqctl.exe -OutFile 'C:\Program Files\kubemqctl\kubemqctl.exe'
$env:Path += ';C:\Program Files\kubemqctl'

Step 3:

Send 'Hello World'

kubemqctl queue send my-queue hello-world

Get 'Hello World'

kubemqctl queue receive my-queue

What's Next

Build & Deploy KubeMQ Components

​

Learn KubeMQ Basics

Learn KubeMQ Message Patterns

Get started with KubeMQ message patterns

​
Previous
What's New
Next - Getting Started
Build & Deploy
Last modified 1yr ago
Copy link
Outline
Welcome to KubeMQ!
Step 0:
Obtain KubeMQ Registration Token
Step 1:
Deploy KubeMQ package
Check Your KubeMQ Cluster Installation:
Step 2:
Install kubemqctl CLI tool
Step 3:
Send 'Hello World'
Get 'Hello World'
What's Next
Build & Deploy KubeMQ Components
Learn KubeMQ Basics
Learn KubeMQ Message Patterns
Get started with KubeMQ message patterns