Welcome to the HiveMQ Community! Glad to see your interest in contributing to HiveMQ Community Edition. Please checkout our Contribution Guide to make sure your contribution will be accepted by the HiveMQ team.
For information on how the HiveMQ Community is organized and how contributions will be accepted please have a look at our HiveMQ Community Repo.
We recommend that you use the IntelliJ IDE for all development on HiveMQ CE.
It will automate your process as much as possible.
Java version 11 is required to build and run HiveMQ CE (for example Azul Zulu JDK).
You can check your installed Java version by entering java -version on the command line.
First you need to fork the HiveMQ Community Edition repository.
Then you can clone the repository:
git clone https://github.com/<your user name>/hivemq-community-edition.gitOpen the HiveMQ CE project folder in IntelliJ. Choose to sync the gradle project, if so prompted by the IDE. After setting the gradle and project SDK (Java 11), you are good to go.
HiveMQ CE uses the HiveMQ Extension SDK which resides in its own repository.
By default, you can not use the latest changes of or modify the Extension SDK.
Please checkout the hivemq-extension-sdk repository next to the hivemq-community-edition repository.
Gradle and IntelliJ will then automatically wire the two projects.
If you only want to use the Extension SDK, execute the following command from the hivemq-community-edition project directory:
git clone https://github.com/hivemq/hivemq-extension-sdk.git ../hivemq-extension-sdkIf you also want to make changes to the Extension SDK, please fork the hivemq-extension-sdk repository and clone your fork:
git clone https://github.com/<your user name>/hivemq-extension-sdk.git ../hivemq-extension-sdkWe truly appreciate and value your time and work. ❤️