IRONSOFTWAREHOME

IronPDF for Java on AWS Elastic Beanstalk

Curtis Chau
Curtis Chau
Updated: June 19, 2026

Deploying IronPDF for Java on AWS Elastic Beanstalk with the Amazon Linux 2023 base image needs extra setup. Amazon Linux 2023 is based on Fedora, so the native dependencies IronPDF relies on must be installed explicitly, and Tomcat needs permission to execute the engine. You configure both through .ebextensions rather than installing IronPDF directly.

1. Grant Tomcat access to the engine

Add an .ebextensions config file that gives Tomcat full access to the IronPDF engine directory:

01_grant_tomcat_root:
  command: chmod -R 777 /usr/share/tomcat10/IronPdfEngine.2024.6.1.Linux.x64/
Text

2. Update the package manager

Refresh dnf so the dependency installs pull current versions:

02_update_dnf:
  command: dnf update -y
Text

3. Install the native dependencies

IronPDF's renderer needs several system libraries. Install them, then make the subprocess executable:

03_install_dependencies:
  command: |
    dnf -y install glibc-devel
    dnf -y install nss
    dnf -y install at-spi2-atk
    dnf -y install libXcomposite
    dnf -y install libXrandr
    dnf -y install mesa-libgbm
    dnf -y install alsa-lib
    dnf -y install pango
    dnf -y install cups-libs
    dnf -y install libXdamage
    dnf -y install libxshmfence
    chmod 755 IronCefSubprocess
Text

With the engine directory writable, dnf current, and these libraries present, IronPDF runs under Tomcat on the Elastic Beanstalk instance. For the full dependency list and other Linux targets, see the IronPDF Linux deployment guide.

Curtis Chau
Technical Writer

Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.

...
Read More

Ready to Get Started?

Version:2026.8just released

Get your free 30-day Trial Key instantly.
No credit card or account creation required
Java Maven Library for PDF
Install with Maven

Version: 2026.8

<dependency>
   <groupId>com.ironsoftware</groupId>
   <artifactId>ironpdf</artifactId>
   <version>2026.8.2</version>
</dependency>
https://central.sonatype.com/artifact/com.ironsoftware/ironpdf/2026.8.2
or
Java PDF JAR
Download JAR

Version: 2026.8

Manually install into your project

Key in blue circle

Get your free 30-day Trial Key instantly.

Your trial license will be sent to your email address

No limitations. 100% unlocked. No credit card.

OR
bullet_checkedNo credit card or account creation requiredNo limitations. 100% unlocked. No credit card.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Book your free Live Demo
Booking Badge

Trusted by Millions of Engineers Worldwide

Iron Software's customer logos
Get Your No-Obligation Consult
Complete the form below or email sales@ironsoftware.com
Your details will always be kept confidential.
Trusted by Millions of Engineers Worldwide
Iron Software's customer logos
Get your free 30-day Trial Key instantly.
No credit card or account creation required
Java Maven Library for PDF
Install with Maven

Version: 2026.8

<dependency>
   <groupId>com.ironsoftware</groupId>
   <artifactId>ironpdf</artifactId>
   <version>2026.8.2</version>
</dependency>
https://central.sonatype.com/artifact/com.ironsoftware/ironpdf/2026.8.2
or
Java PDF JAR
Download JAR

Version: 2026.8

Manually install into your project