How to Run IronPDF for Java in Google Cloud

Chaknith Bin

January 22, 2023

Updated October 20, 2024

Note: We have not fully tested support with Google Cloud but if you want to try, we have some Required Settings.

Important: Required Settings

Zip Deployment is not supported, since IronPDF requires execution of binaries at runtime.
Default Cloud Function Docker images are not working because they lack the required packages required for Chrome to run properly. For more information, see the Google Cloud System Packages.
Please use a custom Dockerfile and install all required packages. Learn more about this in our Linux Deployment Guide.

Include the ironpdf-engine-linux-x64 dependency to your project: (change the version number to latest)

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>2022.xx.x</version>
</dependency>

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>2022.xx.x</version>
</dependency>

XML

This plugin may be required:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.4</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>

            <!--  required for Docker-->
            <configuration>
                <transformers>
                    <transformer
                            implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                </transformers>
            </configuration>

        </execution>
    </executions>
</plugin>

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.4</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>

            <!--  required for Docker-->
            <configuration>
                <transformers>
                    <transformer
                            implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
                </transformers>
            </configuration>

        </execution>
    </executions>
</plugin>

XML

These dependencies may be required:

<dependency>
    <groupId>io.perfmark</groupId>
    <artifactId>perfmark-api</artifactId>
    <version>0.26.0</version>
</dependency>

<dependency>
    <groupId>io.grpc</groupId>
    <artifactId>grpc-okhttp</artifactId>
    <version>1.50.2</version>
</dependency>

<dependency>
    <groupId>io.grpc</groupId>
    <artifactId>grpc-netty-shaded</artifactId>
    <version>1.50.2</version>
</dependency>

<dependency>
    <groupId>io.perfmark</groupId>
    <artifactId>perfmark-api</artifactId>
    <version>0.26.0</version>
</dependency>

<dependency>
    <groupId>io.grpc</groupId>
    <artifactId>grpc-okhttp</artifactId>
    <version>1.50.2</version>
</dependency>

<dependency>
    <groupId>io.grpc</groupId>
    <artifactId>grpc-netty-shaded</artifactId>
    <version>1.50.2</version>
</dependency>

XML

Set timeout to 330 seconds due to slow start.
Set memory size to at least 2048 MB.
Set EphemeralStorage Size to at least 1024 MB.

In some environments, you may need to point at an IronPdfEngineWorkingDirectory and set execution permissions for it:

Setting.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));

Setting.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));

JAVA

RUN chmod 777 /tmp/

Chaknith Bin

Chat with engineering team now

Software Engineer

Chaknith works on IronXL and IronBarcode. He has deep expertise in C# and .NET, helping improve the software and support customers. His insights from user interactions contribute to better products, documentation, and overall experience.