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, andlibgtk2.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-unauthenticatedStep 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 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.
