Apache Pulsar - distributed pub-sub messaging system
Under Apache License 2.0
By apache

pubsub streaming messaging pulsar queuing event-streaming

Pulsar is a distributed pub-sub messaging platform with a very
flexible messaging model and an intuitive client API.

Learn more about Pulsar at https://pulsar.apache.org

Main features


This repository is the main repository of Apache Pulsar. Pulsar PMC also maintains other repositories for
components in the Pulsar ecosystem, including connectors, adapters, and other language clients.

Helm Chart



Dashboard & Management Tools



Build Pulsar

* Java JDK 11 or JDK 8
* Maven 3.6.1+
* zip

Compile and install:

$ mvn install -DskipTests

Compile and install individual module
$ mvn -pl module-name (e.g: pulsar-broker) install -DskipTests

Minimal build (This skips most of external connectors and tiered storage handlers)

mvn install -Pcore-modules,-main

Run Unit Tests:

$ mvn test

Run Individual Unit Test:

$ mvn -pl module-name (e.g: pulsar-client) test -Dtest=unit-test-name (e.g: ConsumerBuilderImplTest)

Run Selected Test packages:

$ mvn test -pl module-name (for example, pulsar-broker) -Dinclude=org/apache/pulsar/**/*.java

Start standalone Pulsar service:

$ bin/pulsar standalone

Check https://pulsar.apache.org for documentation and examples.

Build custom docker images

Docker images must be built with Java 8 for branch-2.7 or previous branches because of
issue 8445.
Java 11 is the recommended JDK version in master/branch-2.8.

This builds the docker images apachepulsar/pulsar-all:latest and apachepulsar/pulsar:latest.

mvn clean install -DskipTests
mvn package -Pdocker,-main -am -pl docker/pulsar-all -DskipTests

After the images are built, they can be tagged and pushed to your custom repository.
Here's an example of a bash script that tags the docker images with the current version and git revision and
pushes them to localhost:32000/apachepulsar.

pulsar_version=$(mvn initialize help:evaluate -Dexpression=project.version -pl . -q -DforceStdout)
gitrev=$(git rev-parse HEAD | colrm 10)
echo "Using tag $tag"
docker tag apachepulsar/pulsar-all:latest ${image_repo_and_project}/pulsar-all:$tag
docker push ${image_repo_and_project}/pulsar-all:$tag
docker tag apachepulsar/pulsar:latest ${image_repo_and_project}/pulsar:$tag
docker push ${image_repo_and_project}/pulsar:$tag

Setting up your IDE

Apache Pulsar is using lombok so you have to ensure your IDE setup with
required plugins.

Configure Project JDK to Java 11 JDK

  1. Open Project Settings.

    Click File -> Project Structure -> Project Settings -> Project.

  2. Select the JDK version.

    From the JDK version drop-down list, select Download JDK... or choose an existing recent Java 11 JDK version.

  3. In the download dialog, select version 11. You can pick a version from many vendors. Unless you have a specific preference, choose AdoptOpenJDK (Hotspot).

Configure Java version for Maven in IntelliJ

  1. Open Maven Importing Settings dialog by going to
    Settings -> Build, Execution, Deployment -> Build Tools -> Maven -> Importing.

  2. Choose Use Project JDK for JDK for Importer setting. This uses the Java 11 JDK for running Maven
    when importing the project to IntelliJ. Some of the configuration in the Maven build is conditional based on
    the JDK version. Incorrect configuration gets chosen when the "JDK for Importer" isn't the same as the "Project JDK".

  3. Validate that the JRE setting in Maven -> Runner dialog is set to Use Project JDK.

Configure annotation processing in IntelliJ

  1. Open Annotation Processors Settings dialog box by going to
    Settings -> Build, Execution, Deployment -> Compiler -> Annotation Processors.

  2. Select the following buttons:

  3. Enable annotation processing

  4. Obtain processors from project classpath

  5. Store generated sources relative to: Module content root

  6. Set the generated source directories to be equal to the Maven directories:

  7. Set "Production sources directory:" to "target/generated-sources/annotations".

  8. Set "Test sources directory:" to "target/generated-test-sources/test-annotations".

  9. Click OK.

  10. Install the lombok plugin in intellij.

Configure code style

  1. Open Code Style Settings dialog box by going to Settings -> Editor -> Code Style.

  2. Click on the :gear: symbol -> Import scheme -> Intellij IDEA code style XML

  3. Pick the file ${pulsar_dir}/src/idea-code-style.xml

  4. On the dialog box that opens, click OK.

  5. Ensure the scheme you just created is selected in Scheme dropdown then click OK.

Configure Checkstyle

  1. Install the Checkstyle-IDEA plugin.

  2. Open Checkstyle Settings dialog box by going to Settings -> Tools -> Checkstyle.

  3. Set Checkstyle version to 8.37.

  4. Set Scan scope to Only Java sources (including tests).

  5. Click + button in the Configuration section to open a dialog to choose the checkfile file.

  6. Enter a Description. For example, Pulsar.

  7. Select Use a local checkstyle file.

  8. Set File to buildtools/src/main/resources/pulsar/checkstyle.xml.

  9. Select Store relative to project location.

  10. Click Next -> Next -> Finish.

  11. Activate the configuration you just added by toggling the corresponding box.

  12. Click OK.

Further configuration in IntelliJ

IntelliJ usage tips


Follow the instructions here
to configure your Eclipse setup.

Build Pulsar docs

Refer to the docs README.

Mailing lists

| Name | Scope | | | |
| [email protected] | User-related discussions | Subscribe | Unsubscribe | Archives |
| [email protected] | Development-related discussions | Subscribe | Unsubscribe | Archives |


Pulsar slack channel at https://apache-pulsar.slack.com/

You can self-register at https://apache-pulsar.herokuapp.com/


Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0

Crypto Notice

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.

The following provides more details on the included cryptographic software: Pulsar uses the SSL library from Bouncy Castle written by http://www.bouncycastle.org.