SummCoder opened a new issue, #10496: URL: https://github.com/apache/rocketmq/issues/10496
### Before Creating the Bug Report - [x] I found a bug, not just asking a question, which should be created in [GitHub Discussions](https://github.com/apache/rocketmq/discussions). - [x] I have searched the [GitHub Issues](https://github.com/apache/rocketmq/issues) and [GitHub Discussions](https://github.com/apache/rocketmq/discussions) of this repository and believe that this is not a duplicate. - [x] I have confirmed that this bug belongs to the current repository, not other repositories of RocketMQ. ### Runtime platform environment Ubuntu 24.04.4 LTS ### RocketMQ version develop|5.5.0 ### JDK Version openjdk version "11.0.31" 2026-04-21 ### Describe the Bug ### Describe the bug When enabling ACL on RocketMQ 5.5.0 for the first time, I followed the official docs (docs/en/acl/Operations_ACL.md). The doc references "distribution/conf/plain_acl.yml" in multiple places as the configuration template, but this file does not exist in the official binary release. Users have to guess the ACL config format from scratch. ### Investigation Verified from two independent sources, same result: 1. Official binary release: downloaded rocketmq-all-5.5.0-bin-release.zip from https://dist.apache.org/repos/dist/release/rocketmq/5.5.0/ → conf/ directory does NOT contain plain_acl.yml 2. Self-compiled from source: built the develop branch (5.5.0) using "mvn -Prelease-all -DskipTests clean install -U", extracted the resulting distribution/target/rocketmq-5.5.0.tar.gz → conf/ directory does NOT contain plain_acl.yml 3. Source tree check: distribution/conf/ under the source root also has no plain_acl.yml. The only copies exist under test resources: - client/src/test/resources/acl_hook/plain_acl.yml - client/src/test/resources/conf/plain_acl_incomplete.yml 4. Duplicate search: searched both open and closed issues on apache/rocketmq for "plain_acl.yml" — no existing report found about the missing template in distribution. ### Steps to Reproduce 1. Download the official 5.5.0 binary release from https://dist.apache.org/repos/dist/release/rocketmq/5.5.0/rocketmq-all-5.5.0-bin-release.zip 2. Extract the zip file 3. Open the conf/ directory 4. Look for plain_acl.yml — it is not there ### What Did You Expect to See? ### Expected behavior A sample plain_acl.yml should be included in the distribution's conf/ directory so users have a working template to customize when enabling ACL, consistent with what the documentation tells them to do. ### What Did You See Instead? The conf/ directory contains no plain_acl.yml. The only configuration files present are broker.conf and tools.yml. Users enabling ACL have no template to work from, despite the official documentation telling them to reference this file. ### Additional Context _No response_ -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
