Skip to Main Content

Deploy Locally

Deploying AutoMQ on a single machine provides an opportunity to explore message sending, receiving, and partition reassignment. It's crucial to understand that this setup is intended solely for testing and learning purposes and should not be used in production environments.

Prerequisites

  • Linux/Mac/Windows Subsystem for Linux

  • Docker

  • Docker Compose version > 2.22.0

  • At least 8GB of free memory

If you experience slow container image download speeds, consider using the Docker Hub Mirror Configuration▸

Install and Launch the AutoMQ Cluster

Execute the following command to establish a test cluster with three AutoMQ nodes. This cluster is set up using Docker Compose to initiate AutoMQ and AWS LocalStack, automatically creating a Bucket and using local files as substitutes for EBS.


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

Once the cluster is successfully launched, the address of the AutoMQ bootstrap server will be displayed in the standard output, as illustrated below:


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

Run the Demo

After launching the AutoMQ cluster, you can execute the demo below to test its 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 you have completed the functionality tests, execute these commands to shut down and remove the AutoMQ cluster.


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