[Public] IronPDF Java on AWS Elastic Beanstalk

Introduction

IronPDF is a powerful PDF library for Java applications, but deploying it on AWS Elastic Beanstalk with Amazon Linux 2023 requires additional configuration. Since Amazon Linux 2023 is based on Fedora Linux, specific dependencies must be installed to ensure smooth operation. This guide outlines the steps to install IronPDF Java on an Elastic Beanstalk environment running Tomcat with root user permissions.

Running Tomcat with Root Permissions

To allow the Tomcat server to access and execute IronPDF correctly, you need to configure custom Elastic Beanstalk extensions (.ebextensions). Instead of installing IronPDF directly, the necessary dependencies should be installed within the extension.

Steps to Install IronPDF Java

1. Grant Root Permissions to Tomcat

Create an .ebextensions configuration file and include the following command to grant the necessary permissions:

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

This command ensures that Tomcat has full access to the IronPDF engine directory.

2. Update Package Manager

Before installing dependencies, update the package manager to ensure you get the latest versions of required libraries:

02_update_dnf:
  command: dnf update -y

3. Install Required Dependencies

IronPDF relies on various system libraries. Install them using the following commands:

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

This step ensures that all required dependencies are available for IronPDF to function correctly on Amazon Linux 2023.

Additional Resources

For more details about IronPDF deployment and dependencies on Linux, refer to the official documentation: IronPDF Linux Deployment Guide.

Conclusion

By following these steps, you can successfully install IronPDF Java on AWS Elastic Beanstalk with Amazon Linux 2023. Properly configuring the .ebextensions file allows for seamless deployment and installation of IronPDF within your Java application.