This is an automated email from the ASF dual-hosted git repository.
lhotari pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/pulsar.git
The following commit(s) were added to refs/heads/master by this push:
new 7a243f1c5ae [improve][doc] Update Java version recommendations in
README (#24913)
7a243f1c5ae is described below
commit 7a243f1c5ae3069109a9a4f4b0d61535a5640bea
Author: Lari Hotari <[email protected]>
AuthorDate: Wed Oct 29 11:49:57 2025 +0200
[improve][doc] Update Java version recommendations in README (#24913)
---
README.md | 98 ++++++++++++++++++++++++++++++++++++++++++++-------------------
1 file changed, 69 insertions(+), 29 deletions(-)
diff --git a/README.md b/README.md
index 80aba79e7eb..d7c48e1e71e 100644
--- a/README.md
+++ b/README.md
@@ -98,38 +98,66 @@ components in the Pulsar ecosystem, including connectors,
adapters, and other la
## Pulsar Runtime Java Version Recommendation
-- pulsar ver > 4.0 and master branch
+> **Note**:
+>
+> When using Java versions, it is recommended to
+> use [a recent version of a particular Java release (17 or
21)](https://adoptium.net/en-GB/temurin/releases?version=21&os=linux&arch=any)
+> with the most recent bug fixes and security patches.
+> For example, the JVM bug
[JDK-8351933](https://bugs.openjdk.org/browse/JDK-8351933) can cause stability
issues in
+> Pulsar.
+> [JDK-8351933](https://bugs.openjdk.org/browse/JDK-8351933) was fixed in Java
17.0.17+ and Java 21.0.8+.
+> Pulsar Docker images come with the most recent Java version at the time of
release.
+
+When using the Pulsar Java client, it is recommended to [set specific system
properties and JVM
options](https://pulsar.apache.org/docs/next/client-libraries-java-setup/#java-client-performance)
to allow optimal performance.
+
+
+### pulsar ver >= 4.1 and master branch
+
+| Component | Java Version |
+|-----------------|:------------:|
+| Broker | 21 |
+| Functions / IO | 21 |
+| CLI | 17 or 21 |
+| Java Client | 17 or 21 |
+
+Docker image Java runtime: 21
-| Components | Java Version |
-|----------------|:------------:|
-| Broker | 17 |
-| Functions / IO | 17 |
-| CLI | 17 |
-| Java Client | 17 |
+### 3.3 <= pulsar ver <= 4.0
-- pulsar ver > 2.10 and master branch
+| Component | Java Version |
+|-----------------|:---------------:|
+| Broker | 21 |
+| Functions / IO | 21 |
+| CLI | 17 or 21 |
+| Java Client | 8, 11, 17 or 21 |
-| Components | Java Version |
+Docker image Java runtime: 21
+
+### 2.10 <= pulsar ver <= 3.0
+
+| Component | Java Version |
|----------------|:-------------:|
| Broker | 17 |
| Functions / IO | 17 |
| CLI | 17 |
| Java Client | 8 or 11 or 17 |
-- 2.8 <= pulsar ver <= 2.10
+Docker image Java runtime: 17
-| Components | Java Version |
-|----------------|:------------:|
-| Broker | 11 |
-| Functions / IO | 11 |
-| CLI | 8 or 11 |
-| Java Client | 8 or 11 |
+### 2.8 <= pulsar ver <= 2.10
-- pulsar ver < 2.8
+| Component | Java Version |
+|-----------------|:------------:|
+| Broker | 11 |
+| Functions / IO | 11 |
+| CLI | 8 or 11 |
+| Java Client | 8 or 11 |
-| Components | Java Version |
-|------------|:------------:|
-| All | 8 or 11 |
+### pulsar ver < 2.8
+
+| Component | Java Version |
+|-------------|:------------:|
+| All | 8 or 11 |
## Build Pulsar
@@ -137,15 +165,18 @@ components in the Pulsar ecosystem, including connectors,
adapters, and other la
- JDK
- | Pulsar Version | JDK Version |
- |-------------------|:-------------------------------------------------:|
- | master and 2.11 + | [JDK 17](https://adoptium.net/?variant=openjdk17) |
- | 2.8 / 2.9 / 2.10 | [JDK 11](https://adoptium.net/?variant=openjdk11) |
- | 2.7 - | [JDK 8](https://adoptium.net/?variant=openjdk8) |
+ | Pulsar Version | JDK Version
|
+
|------------------|:--------------------------------------------------------------------------------:|
+ | master and 4.0+ | [JDK
21](https://adoptium.net/en-GB/temurin/releases?version=21&os=any&arch=any) |
+ | 2.11 + | [JDK
17](https://adoptium.net/en-GB/temurin/releases?version=17&os=any&arch=any) |
+ | 2.8 / 2.9 / 2.10 | [JDK
11](https://adoptium.net/en-GB/temurin/releases?version=11&os=any&arch=any) |
+ | 2.7 - | [JDK
8](https://adoptium.net/en-GB/temurin/releases?version=8&os=any&arch=any) |
-- Maven 3.6.1+
+- Maven 3.9.9+
- zip
+There is also a guide for [setting up the tooling for building
Pulsar](https://pulsar.apache.org/contribute/setup-buildtools/).
+
> **Note**:
>
> This project includes a [Maven Wrapper](https://maven.apache.org/wrapper/)
> that can be used instead of a system-installed Maven.
@@ -205,7 +236,8 @@ Here are some general instructions for building custom
docker images:
* Docker images must be built with Java 8 for `branch-2.7` or previous
branches because of [ISSUE-8445](https://github.com/apache/pulsar/issues/8445).
* Java 11 is the recommended JDK version in `branch-2.8`, `branch-2.9` and
`branch-2.10`.
-* Java 17 is the recommended JDK version in `master`.
+* Java 17 is the recommended JDK version in `branch-2.11`, `branch-3.0` and
`branch-3.3`.
+* Java 21 is the recommended JDK version since `branch-4.0`.
The following command builds the docker images
`apachepulsar/pulsar-all:latest` and `apachepulsar/pulsar:latest`:
@@ -244,10 +276,18 @@ Read https://pulsar.apache.org/contribute/setup-ide for
setting up IntelliJ IDEA
##### Mailing lists
+* The mailing lists are the primary contact for the Apache Pulsar project.
+* Your email to the mailing list might be placed in a moderation queue if you
haven't joined the mailing list by subscribing before posting.
+
+> **Note**
+>
+> Please note that security-related issues or concerns should not be reported
in public channels.
+> Follow the instructions in the [Security
Policy](https://pulsar.apache.org/security/) to contact the [ASF Security
Team](https://www.apache.org/security/) and the Apache Pulsar PMC directly.
+
| Name | Scope
| Subscribe |
Unsubscribe | Archives
|
|:----------------------------------------------------------|:--------------------------------|:------------------------------------------------------|:----------------------------------------------------------|:-------------------------------------------------------------------|
-| [[email protected]](mailto:[email protected]) | User-related
discussions | [Subscribe](mailto:[email protected]) |
[Unsubscribe](mailto:[email protected]) |
[Archives](http://mail-archives.apache.org/mod_mbox/pulsar-users/) |
-| [[email protected]](mailto:[email protected]) |
Development-related discussions |
[Subscribe](mailto:[email protected]) |
[Unsubscribe](mailto:[email protected]) |
[Archives](http://mail-archives.apache.org/mod_mbox/pulsar-dev/) |
+| [[email protected]](mailto:[email protected]) | User-related
discussions |
[Subscribe](mailto:[email protected]?subject=subscribe&body=subscribe)
|
[Unsubscribe](mailto:[email protected]?subject=unsubscribe&body=unsubscribe)
| [Archives](https://lists.apache.org/[email protected]) |
+| [[email protected]](mailto:[email protected]) |
Development-related discussions |
[Subscribe](mailto:[email protected]?subject=subscribe&body=subscribe)
|
[Unsubscribe](mailto:[email protected]?subject=unsubscribe&body=unsubscribe)
| [Archives](https://lists.apache.org/[email protected]) |
##### Slack
