IronPDF for Java on AWS Elastic Beanstalk

Updated:June 18, 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/

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

YAML

2. Update the package manager

Refresh dnf so the dependency installs pull current versions:

02_update_dnf:
  command: dnf update -y

02_update_dnf:
  command: dnf update -y

YAML

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

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

YAML

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

Chat with engineering team now

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.

...

Ready to Get Started?

Version: 2026.5 just released