Apache RocketMQ 4.9.8 Setup and ACL 1.0 Configuration

Downloading RocketMQ 4.9.8

Download the release package from the official reppository:

https://dist.apache.org/repos/dist/release/rocketmq/4.9.8/rocketmq-all-4.9.8-bin-release.zip

Extract it to a local directory such as: D:\dev\env\rocketmq-4.9.8

Configuring ACL 1.0 for Access Control

Official documentation: RocketMQ ACL Guide

- ACL 1.0 is deprecated starting from RocketMQ 5.3.3; consider upgrading to ACL 2.0.

  • Ensure the ROCKETMQ_HOME environment variible is configured before starting the service.

#### Enable ACL in Broker Configuration

Edit conf/broker.conf and set:

aclEnable=true

Define Access Credentials in plain_acl.yml

Update conf/plain_acl.yml with the following contant:

accounts:
  - accessKey: myrocketmq
    secretKey: 12345678
    admin: true

Set Credentials in Tools Configuration

Modify conf/tools.yml with the same access key and secret key:

accessKey: myrocketmq
secretKey: 12345678

Starting RocketMQ

Set the environment variable and launch the NameServer and Broker:

set ROCKETMQ_HOME=D:\dev\env\rocketmq-4.9.8
start "RocketNameServer" cmd /K call D:\dev\env\rocketmq-4.9.8\bin\mqnamesrv.cmd
start "RocketBroker" cmd /K call D:\dev\env\rocketmq-4.9.8\bin\mqbroker.cmd -n 127.0.0.1:9876 -c D:\dev\env\rocketmq-4.9.8\conf\broker.conf

For Unix-like systems:

nohup sh bin/mqnamesrv &
nohup sh bin/mqbroker -n 127.0.0.1:9876 -c conf/broker.conf &

Update Nacos Configuration

Add the following configuration in the global.yaml file:

rocketmq:
  enable-acl: true
  producer:
    access-key: myrocketmq
    secret-key: 12345678

Deploying RocketMQ Dashboard

Download and Build

Clone the dashboard from GitHub:

https://github.com/apache/rocketmq-dashboard

Configure Dashboard Properties

Edit application.properties and add:

rocketmq.config.namesrvAddr=127.0.0.1:9876
rocketmq.config.loginRequired=true
rocketmq.config.accessKey=myrocketmq
rocketmq.config.secretKey=12345678

Create Admin User

In users.properties, define the admin account:

mqadmin=12345678,1

Build the Dashboard

mvn clean package -DskipTests=true

Launch the Dashboard Service

java -jar rocketmq-dashboard-2.1.0.jar --server.port=8082 --rocketmq.config.namesrvAddr=127.0.0.1:9876 --rocketmq.config.loginRequired=true --rocketmq.config.accessKey=myrocketmq --rocketmq.config.secretKey=12345678

Tags: rocketmq ACL access control Authentication Authorization

Posted on Wed, 01 Jul 2026 16:27:12 +0000 by pbeerman