# Deploy KubeMQ (/deploy)



## One broker, two jobs [#one-broker-two-jobs]

KubeMQ is a Kubernetes-native message broker that ships as a single binary with two co-equal headline capabilities.

**Consolidate your messaging stack** — point your existing Kafka, RabbitMQ, AWS SQS/SNS, MQTT, STOMP, AMQP, or Google Cloud Pub/Sub client at KubeMQ by changing one connection string. No rewrite, no new SDK, no new wire protocol to learn.

**Run your AI-agent fabric** — KubeMQ ships built-in **Agent-to-Agent (A2A)** and **Model Context Protocol (MCP)** gateways. Agents register, get discovered by capability, and stream results; any MCP-compatible LLM host — Claude, Cursor, or your own IDE — drives both messaging and agents over the open MCP standard.

Both capabilities ride the same core:

* **10-language SDKs plus REST**
* **Four messaging patterns** (Events, Events Store, Queues, and RPC — Commands and Queries)
* Built-in persistence
* A web dashboard
* Clustering and high availability
* No ZooKeeper, no external database, no sidecars

## Choose your path [#choose-your-path]

### What do you want to do [#what-do-you-want-to-do]

Two things KubeMQ does — pick the one you came for.

<Cards>
  <Card title="Replace your messaging stack" href="/deploy/scenarios/replace" description="Point your existing Kafka, RabbitMQ, AWS SQS/SNS, MQTT, STOMP, AMQP, or Google Cloud Pub/Sub client at KubeMQ — change one connection string, keep your code." />

  <Card title="Build on the AI-agent fabric" href="/deploy/scenarios/agents" description="Connect an MCP host, register an agent, or drive messaging and agents from an LLM over the built-in Agent-to-Agent (A2A) and Model Context Protocol (MCP) gateways." />
</Cards>

### Ways to get started [#ways-to-get-started]

Or just get it running:

<Cards>
  <Card title="Build native (SDKs)" href="/deploy/quickstart" description="Run KubeMQ, open the dashboard, and round-trip your first message using a native SDK." />

  <Card title="Drive from the terminal (kmq CLI)" href="/deploy/cli" description="Install the kmq CLI, connect to a running server, and send your first message without writing code." />

  <Card title="Deploy to production" href="/deploy/kubernetes-helm" description="Install KubeMQ on Kubernetes with the Helm charts and operator, with a production readiness checklist." />
</Cards>

## The four messaging patterns [#the-four-messaging-patterns]

<Cards>
  <Card title="Events" href="/learn/events" description="Fire-and-forget pub/sub for real-time broadcasting to multiple subscribers." />

  <Card title="Events Store" href="/learn/events-store" description="Persistent pub/sub with replay, retention policies, and consumer groups." />

  <Card title="Queues" href="/learn/queues" description="Point-to-point messaging with guaranteed delivery, acknowledgment, and dead-letter queues." />

  <Card title="RPC" href="/learn/rpc" description="Request-reply messaging for commands (execute and confirm) and queries (request data)." />
</Cards>

## Upgrading an existing install? [#upgrading-an-existing-install]

Rolling upgrades, rollback, and backup are covered in [Install with Docker](/deploy/docker) and [Install on Kubernetes](/deploy/kubernetes-helm).