IronPDF in AWS Lambda .NET 8: Missing Chromium Binary Errors

When running IronPDF inside an AWS Lambda .NET 8 container image, the application fails with an exception indicating that the embedded Chromium binary cannot be found.

IronSoftware.Exceptions.IronSoftwareEmbeddedDeploymentMissingException:
Failed to find embedded resource 'Chrome.linux-x64.zip'

The full exception stack may appear as:

Unhandled exception. System.Exception: Error while convert DOCX document to HTML:
IronSoftware.Exceptions.IronSoftwareEmbeddedDeploymentMissingException: Failed to find embedded resource 'Chrome.linux-x64.zip'
   at IronSoftware.Deployment.AssetManager.GetEmbededResourceStream(...)
   at IronSoftware.Deployment.EmbeddedResourceDeployment.Deploy()
   at IronPdf.Engines.Chrome.LocalChromeClient.Initialize()

Three conditions cause this error. First, if the AWS Lambda Mock Test Tool runs the function on Windows while the Dockerfile targets Linux, the embedded resource platform does not match the runtime. Second, IronPdf.Slim is a Linux-only package and fails when the runtime is Windows. Third, the container base image may not satisfy IronPDF's platform requirements.

Solution

Step 1: Test on the correct Linux runtime

Do not test Lambda functions using the Mock Test Tool on Windows. Use Docker locally to replicate the Lambda environment:

docker build -t my-lambda-test .
docker run --rm my-lambda-test
docker build -t my-lambda-test .
docker run --rm my-lambda-test
SHELL

Step 2: Use the full IronPDF package for cross-platform support

If you need to run on both Windows and Linux, use IronPdf rather than IronPdf.Slim:

Install-Package IronPdf

IronPdf.Slim is Linux-only. IronPdf includes embedded binaries for both platforms.

Step 3: Install Linux dependencies in the Dockerfile

FROM public.ecr.aws/lambda/dotnet:8

RUN yum install -y \
    pango.x86_64 libXcomposite.x86_64 libXcursor.x86_64 libXdamage.x86_64 \
    libXext.x86_64 libXi.x86_64 libXtst.x86_64 cups-libs.x86_64 \
    libXScrnSaver.x86_64 libXrandr.x86_64 GConf2.x86_64 alsa-lib.x86_64 \
    atk.x86_64 gtk3.x86_64 ipa-gothic-fonts \
    xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi \
    xorg-x11-utils xorg-x11-fonts-cyrillic \
    xorg-x11-fonts-Type1 xorg-x11-fonts-misc \
    glibc-devel.x86_64 at-spi2-atk.x86_64 mesa-libgbm.x86_64

For the full AWS Lambda Docker configuration, see the AWS 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?
Nuget Downloads 19,345,590 | Version: 2026.6 just released
Still Scrolling Icon

Still Scrolling?

Want proof fast? PM > Install-Package IronPdf
run a sample watch your HTML become a PDF.