Skip to Main Content

Deploy Locally

Deploying AutoMQ in a standalone environment enables you to explore functions like message transmission, reception, and partition reassignment. It's crucial to recognize that this configuration is intended solely for testing and learning purposes and should not be utilized in production environments.


  • Linux/Mac/Windows Subsystem for Linux

  • Docker

  • Docker Compose version > 2.22.0

  • At least 8GB of free memory

If you are experiencing slow container image download speeds, consider consulting the Docker Hub Mirror Configuration▸

Install and Initiate the AutoMQ Cluster

Execute the following command to establish a test cluster comprising three AutoMQ nodes. This setup initiates AutoMQ and AWS LocalStack using Docker Compose, automatically generates a Bucket, and uses local files as substitutes for EBS.

curl | bash

Upon successful initiation, the AutoMQ bootstrap server's address will be displayed in the standard output, as illustrated in the example below:

AutoMQ has been successfully installed. You can now access AutoMQ from the bootstrap server address.

Run the Demo

After initiating the AutoMQ cluster, proceed with executing the demo program below to confirm its operational capabilities.

  1. Example: Produce & Consume Message▸

  2. Example: Simple Benchmark▸

  3. Example: Partition Reassignment in Seconds▸

  4. Example: Self-Balancing When Cluster Nodes Change▸

  5. Example: Continuous Data Self-Balancing▸

Shutdown and Uninstall the AutoMQ Cluster

Once the functionality test is complete, execute the following commands to deactivate and remove the AutoMQ cluster.

curl | bash