How to Run IronPDF for Java in Google Cloud

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 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 the 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 Ephemeral Storage Size to at least 1024 MB.

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

  // Set the working directory for the IronPDF Engine
  Setting.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));

  // Set the working directory for the IronPDF Engine
  Setting.setIronPdfEngineWorkingDirectory(Paths.get("/tmp/"));

  JAVA

  # Grant full read/write/execute permissions to the /tmp directory
  RUN chmod 777 /tmp/