Skip to Main Content

Deploy Locally

Deploying AutoMQ in a single-node environment allows you to experience message sending, receiving, and partition reassignment features. It is important to note that this setup is only suitable for testing and learning purposes and is not recommended for production environments.

Prerequisites​

  • Linux/Mac/Windows Subsystem for Linux

  • Docker

  • Docker Compose version > 2.22.0

  • At least 8GB of free memory

If downloading container images is slow, refer to Docker Hub Mirror Configuration▸

Installing and Starting the AutoMQ Cluster​

Use the following command to create a test cluster with 3 AutoMQ nodes. This cluster uses Docker Compose to start AutoMQ and AWS LocalStack, automatically creating a bucket and assigning local files to replace EBS.


curl https://download.automq.com/community_edition/standalone_deployment/install_run.sh | bash

Upon successful startup, the address of the AutoMQ bootstrap server will be printed in the standard output, as shown below:


AutoMQ has been successfully installed. You can now access AutoMQ from the bootstrap server address.
localhost:9094,localhost:9095

Run the Demo​

After starting the AutoMQ cluster, you can run the following demo program to verify its functionality.

  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▸

Stop and Uninstall the AutoMQ Cluster​

After completing the feature tests, please run the following command to stop and uninstall the AutoMQ cluster.


curl https://download.automq.com/community_edition/standalone_deployment/stop_uninstall.sh | bash

Related Content​