apache / apache/pulsar

[Bug] Starting Docker Compose and running Pulsar 4.0.5 will result in an error

Open
#24,347 4 comments 0 reactions 0 assignees View on GitHub
type/bug
Dominant language
Java
Stars
15.3k
Forks
3.8k
Avg merge
1d 14h
Merged PRs (30d)
160

Description

### Search before reporting

- [x] I searched in the [issues](https://github.com/apache/pulsar/issues) and found nothing similar.

### Read release policy

- [x] I understand that [unsupported versions](https://pulsar.apache.org/contribute/release-policy/#supported-versions) don't get bug fixes. I will attempt to reproduce the issue on a supported version of Pulsar client and Pulsar broker.

### User environment

version:4.0.5

document::https://pulsar.apache.org/docs/4.0.x/getting-started-docker-compose

### Issue Description

An error occurred while executing Docker Compose. I hope Pulsar can run normally

### Error messages

```text
2025-05-26 09:56:27 picocli.CommandLine$MissingParameterException: Missing required options: '--cluster=', '--web-service-url='
2025-05-26 09:56:27 Exception in thread "main" picocli.CommandLine$MissingParameterException: Missing required options: '--cluster=', '--web-service-url='
2025-05-26 09:56:27 at picocli.CommandLine$MissingParameterException.create(CommandLine.java:18661)
2025-05-26 09:56:27 at picocli.CommandLine$MissingParameterException.access$21200(CommandLine.java:18649)
2025-05-26 09:56:27 at picocli.CommandLine$Interpreter.validateConstraints(CommandLine.java:13651)
2025-05-26 09:56:27 at picocli.CommandLine$Interpreter.parse(CommandLine.java:13614)
2025-05-26 09:56:27 at picocli.CommandLine$Interpreter.parse(CommandLine.java:13559)
2025-05-26 09:56:27 at picocli.CommandLine$Interpreter.parse(CommandLine.java:13454)
2025-05-26 09:56:27 at picocli.CommandLine.parseArgs(CommandLine.java:1552)
2025-05-26 09:56:27 at org.apache.pulsar.PulsarClusterMetadataSetup.main(PulsarClusterMetadataSetup.java:227)
2025-05-26 09:56:28 bash: line 2: --cluster: command not found
2025-05-26 09:56:28 bash: line 3: --zookeeper: command not found
2025-05-26 09:56:28 bash: line 4: --configuration-store: command not found
2025-05-26 09:56:28 bash: line 5: --web-service-url: command not found
2025-05-26 09:56:28 bash: line 6: --broker-service-url: command not found
```

### Reproducing the issue

Executing the command 'docker compose up - d' resulted in an error
![Image](https://github.com/user-attachments/assets/d497075b-76ad-407e-ba25-8f99c861cdf9)

### Additional information

_No response_

### Are you willing to submit a PR?

- [x] I'm willing to submit a PR!

Contributor guide

Open the contributing guide

Research direction

Reproduce the failure using the 4.0.x getting-started Docker Compose document and `docker compose up -d`, then inspect the Compose setup and the `PulsarClusterMetadataSetup.main` entry point named in the stack trace. Compare how the required options are passed and verify that the Pulsar 4.0.5 cluster starts without the missing-parameter and shell errors.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker-compose, java
Domain
devops, infrastructure
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
28/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.