feat(docker): update base images to Java 25, Spring 4, Jackson 3, Gradle 9 and optimize JVM options (Project Lilliput) by balazs-szucs · Pull Request #5725 · Stirling-Tools/Stirling-PDF

balazs-szucs · 2026-02-14T15:12:33Z

Description of Changes

This PR upgrades Stirling-PDF to Java 25, Spring Boot 4.0.2, Jackson 3, and Gradle 9.3.1. It introduces Project Lilliput (Compact Object Headers) for reduced memory overhead, Project Leyden AOT caching for faster startup, and modernizes JVM configurations with virtual threads and improved garbage collection options. The changes also optimize Docker images, refactor init scripts with dynamic memory detection, and migrate from deprecated Spring Security SAML APIs.

Changes:

Upgraded runtime to Java 25 with Java 21 source/target compatibility, Gradle 9.3.1, Spring Boot 4.0.2, and Jackson 3
Added Project Lilliput support with runtime detection, Project Leyden AOT cache generation for 15-25% faster startup
Modernized JVM options: replaced experimental G1 flags, added virtual thread support, migrated ThreadPoolTaskExecutor to virtual threads
Updated Docker images to use eclipse-temurin:25-jre with optimized multi-stage builds and dynamic memory detection

Checklist

General

I have read the Contribution Guidelines
I have read the Stirling-PDF Developer Guide (if applicable)
I have read the How to add new languages to Stirling-PDF (if applicable)
I have performed a self-review of my own code
My changes generate no new warnings

Documentation

I have updated relevant docs on Stirling-PDF's doc repo (if functionality has heavily changed)
I have read the section Add New Translation Tags (for new translation tags only)

Translations (if applicable)

I ran scripts/counter_translation.py

UI Changes (if applicable)

Screenshots or videos demonstrating the UI changes are attached (e.g., as comments or direct attachments in the PR)

Testing (if applicable)

I have tested my changes locally. Refer to the Testing Guide for more details.

Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

…capabilities Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

…backports Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

…and exclude additional temporary files

stirlingbot · 2026-02-20T14:59:52Z

🚀 PR Test Deployment

Your PR has been deployed for testing!

🔗 Test URL: http://23.22.230.180:5725
Security Disabled

This deployment will be automatically cleaned up when the PR is closed.

…T training with PostgreSQL mode

stirlingbot · 2026-02-20T15:34:21Z

🚀 PR Test Deployment

Your PR has been deployed for testing!

🔗 Test URL: http://23.22.230.180:5725
Security Disabled

This deployment will be automatically cleaned up when the PR is closed.

…g in various components

stirlingbot · 2026-02-20T16:37:02Z

🚀 PR Test Deployment

Your PR has been deployed for testing!

🔗 Test URL: http://23.22.230.180:5725
Security Disabled

This deployment will be automatically cleaned up when the PR is closed.

Copilot

Pull request overview

Copilot reviewed 100 out of 101 changed files in this pull request and generated 7 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

docker/backend/Dockerfile.fat

docker/backend/Dockerfile

docker/Dockerfile.unified

docker/embedded/Dockerfile.fat

docker/embedded/Dockerfile

docker/backend/Dockerfile.fat

stirlingbot · 2026-02-21T12:19:26Z

🚀 PR Test Deployment

Your PR has been deployed for testing!

🔗 Test URL: http://23.22.230.180:5725
Security Disabled

This deployment will be automatically cleaned up when the PR is closed.

…gurations Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

stirlingbot · 2026-02-21T14:12:15Z

🚀 PR Test Deployment

Your PR has been deployed for testing!

🔗 Test URL: http://23.22.230.180:5725
Security Disabled

This deployment will be automatically cleaned up when the PR is closed.

# Conflicts: # testing/test.sh

…d configurations

…to avoid library conflicts

…d bump Calibre version to 9.3.1

…TIONS for JDK 25+ compatibility and bump ImageMagick version to 7.1.2-13

…tting

stirlingbot · 2026-02-22T13:14:55Z

🚀 PR Test Deployment

Your PR has been deployed for testing!

🔗 Test URL: http://23.22.230.180:5725
Security Disabled

This deployment will be automatically cleaned up when the PR is closed.

…atibility

stirlingbot · 2026-02-22T14:55:42Z

🚀 PR Test Deployment

Your PR has been deployed for testing!

🔗 Test URL: http://23.22.230.180:5725
Security Disabled

This deployment will be automatically cleaned up when the PR is closed.

…lity

stirlingbot · 2026-02-22T15:14:40Z

🚀 PR Test Deployment

Your PR has been deployed for testing!

🔗 Test URL: http://23.22.230.180:5725
Security Disabled

This deployment will be automatically cleaned up when the PR is closed.

…ions in GlobalExceptionHandler

balazs-szucs · 2026-02-22T15:18:39Z

/deploypr

stirlingbot · 2026-02-22T15:33:04Z

🚀 PR Test Deployment

Your PR has been deployed for testing!

🔗 Test URL: http://23.22.230.180:5725
Security Disabled

This deployment will be automatically cleaned up when the PR is closed.

balazs-szucs and others added 6 commits February 7, 2026 12:47

feat(deps): upgrade Jackson to tools.jackson and Spring to version 4

ba91c3c

Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

feat(deps): add Spring Boot WebMVC test starter for enhanced testing …

0cfa433

…capabilities Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

Merge branch 'main' into spring4

6f4dcd9

Merge branch 'main' into spring4

4b808bf

Merge branch 'main' into spring4

9af1b23

feat(docker): update base images to Java 25 and optimize JVM options

e66e4a0

Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

balazs-szucs and others added 5 commits February 14, 2026 16:13

feat(build): remove JDK 17 from build matrix for improved compatibility

f646214

Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

feat(build): update JDK version to 25 in build configuration

167b5d6

Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

fix(docker): remove gpgv from package purge in Dockerfile

1e14457

Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

fix(docker): simplify package installation in Dockerfile by removing …

eefb0ae

…backports Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

Merge branch 'main' into java25spring4

dfe51eb

balazs-szucs marked this pull request as ready for review February 15, 2026 17:11

Copilot AI review requested due to automatic review settings February 15, 2026 17:11

balazs-szucs requested review from ConnorYoh, EthanHealy01, Frooodle, Ludy87, jbrunton96 and reecebrowne as code owners February 15, 2026 17:11

dosubot bot added the size:L This PR changes 100-499 lines ignoring generated files. label Feb 15, 2026

Copilot started reviewing on behalf of balazs-szucs February 15, 2026 17:11 View session

fix: enhance init-without-ocr.sh and test.sh to improve AOT handling …

658057b

…and exclude additional temporary files

fix: update init-without-ocr.sh and DatabaseConfig.java to support AO…

bdf2417

…T training with PostgreSQL mode

fix: refactor to use virtual threads for executors and enhance loggin…

04f4082

…g in various components

balazs-szucs requested a review from Copilot February 20, 2026 16:49

Copilot started reviewing on behalf of balazs-szucs February 20, 2026 16:50 View session

Copilot AI reviewed Feb 20, 2026

View reviewed changes

Merge branch 'main' into java25spring4

e23fb06

fix: clean up Dockerfiles by removing unnecessary resources and confi…

7bc7b01

…gurations Signed-off-by: Balázs Szücs <bszucs1209@gmail.com>

balazs-szucs added 6 commits February 22, 2026 10:56

Merge branch 'main' into java25spring4

71f56e7

# Conflicts: # testing/test.sh

fix: add Ghostscript 10.06.0 support in Dockerfiles and update relate…

50604a8

…d configurations

fix: add isolated build stage for Ghostscript 10.06.0 in Dockerfiles …

73eb5f3

…to avoid library conflicts

fix: update Dockerfiles to add JAVA_TOOL_OPTIONS for javac exports an…

5311a1b

…d bump Calibre version to 9.3.1

fix: update Dockerfiles to replace JAVA_TOOL_OPTIONS with JDK_JAVA_OP…

43c615d

…TIONS for JDK 25+ compatibility and bump ImageMagick version to 7.1.2-13

fix: update googleJavaFormatVersion to 1.34.1 for improved code forma…

f347297

…tting

fix: update JDK version from 21 to 25 in configuration files for comp…

8248746

…atibility

stirlingbot bot added the Devtools Development tools label Feb 22, 2026

fix: update JDK version in configuration files from 25 to 21 for comp…

46f43a7

…atibility

stirlingbot bot removed the Devtools Development tools label Feb 22, 2026

fix: update JDK version in testdriver.yml from 25 to 21 for compatibi…

979cd40

…lity

fix: enhance AOT cache management and handle client disconnect except…

4329aab

…ions in GlobalExceptionHandler

Comments

Conversation

balazs-szucs commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description of Changes

Checklist

General

Documentation

Translations (if applicable)

UI Changes (if applicable)

Testing (if applicable)

Uh oh!

stirlingbot bot commented Feb 20, 2026

🚀 PR Test Deployment

Uh oh!

stirlingbot bot commented Feb 20, 2026

🚀 PR Test Deployment

Uh oh!

stirlingbot bot commented Feb 20, 2026

🚀 PR Test Deployment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

stirlingbot bot commented Feb 21, 2026

🚀 PR Test Deployment

Uh oh!

stirlingbot bot commented Feb 21, 2026

🚀 PR Test Deployment

Uh oh!

stirlingbot bot commented Feb 22, 2026

🚀 PR Test Deployment

Uh oh!

stirlingbot bot commented Feb 22, 2026

🚀 PR Test Deployment

Uh oh!

stirlingbot bot commented Feb 22, 2026

🚀 PR Test Deployment

Uh oh!

balazs-szucs commented Feb 22, 2026

Uh oh!

stirlingbot bot commented Feb 22, 2026

🚀 PR Test Deployment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

balazs-szucs commented Feb 14, 2026 •

edited

Loading