Java AMQP Client Library Build Instructions

This section describes the process for obtaining a copy of the RabbitMQ Java AMQP client source code, as well as instructions for building the Java client from source.

Obtaining the source

Check the code out directly from our GitHub repositories:

git clone rabbitmq_codegen
git clone

Be aware that the code-generation module is a dependency of the Java client library.

Required Libraries and Tools

In order to build RabbitMQ Java AMQP client library, you will need a few tools.

The Java client libraries requires a recent version of Python and (an implementation of a JSON reader and writer in Python), for generating AMQP 0-9-1 framing code. is included as a standard json library in the Python core since 2.6 release.

Additionally, for building the Java client libraries, you will need

Building the Java client libraries

Ensure JAVA_HOME is correctly set and that the rabbitmq-java-client and rabbitmq_codegen directories are in the same directory. Change to the rabbitmq-java-client directory and launch the build:

cd rabbitmq-java-client
./mvnw clean package -Ddeps.dir=../ -DskipTests
The generated JAR file will be in target.

This procedure is enough if you want to build the Java Client yourself. If you want to make significant changes or contribute to the Java Client, please follow the instructions on the library repository. They cover among others how to properly run the test suite.

Getting Help and Providing Feedback

If you have questions about the contents of this guide or any other topic related to RabbitMQ, don't hesitate to ask them on the RabbitMQ mailing list.

Help Us Improve the Docs <3

If you'd like to contribute an improvement to the site, its source is available on GitHub. Simply fork the repository and submit a pull request. Thank you!