Fixing IronPDF Deployment Issues on Google Cloud Run

IronPDF fails to generate PDFs or crashes when deployed to Google Cloud Run 1st Generation. Three failure modes are common:

  • Application crashing or producing segmentation faults during PDF generation
  • Dependency failures caused by missing graphical libraries such as libglib2.0-0, libxkbcommon-x11-0, and libgtk2.0-0
  • GPU or rendering errors when the environment lacks graphics acceleration support

Google Cloud Run 1st Generation uses Linux kernel 4.4.0, which lacks the support required by IronPDF's Chrome-based renderer. The 2nd Generation environment uses kernel 6.4.10 and resolves these compatibility problems.

Solution

Step 1: Switch to the 2nd Generation execution environment

Add --execution-environment gen2 to your deployment command:

gcloud run deploy my-ironpdf-service \
    --image gcr.io/my-project/my-ironpdf-app \
    --platform managed \
    --region us-central1 \
    --execution-environment gen2 \
    --allow-unauthenticated
gcloud run deploy my-ironpdf-service \
    --image gcr.io/my-project/my-ironpdf-app \
    --platform managed \
    --region us-central1 \
    --execution-environment gen2 \
    --allow-unauthenticated
SHELL

Step 2: Update your Dockerfile with the required dependencies

FROM --platform=linux/amd64 mcr.microsoft.com/dotnet/aspnet:8.0 AS base
USER root
WORKDIR /app
EXPOSE 8080

RUN apt update && apt install -y \
    sudo libglib2.0-0 libxkbcommon-x11-0 libc6 libc6-dev \
    libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 \
    libxcb-dri3-0 libdrm-common libgbm1 libasound2 \
    libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev \
    libstdc++6 libxcomposite1 \
    && rm -rf /var/lib/apt/lists/*

COPY . .
RUN dotnet publish -c Release -o /app/publish

CMD ["dotnet", "/app/publish/myapp.dll"]

For the full list of required packages by Linux distribution, see the 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?
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.