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
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.

