Stirling PDF

To deploy Stirling PDF securely on a remote server, you should run the official Docker container behind a reverse proxy such as Nginx or Caddy configured with TLS 1.3 encryption. You must also implement an authentication layer, as the community edition defaults to open access, by enabling the built-in login portal via environment variables like 'SECURITY_ENABLED=true'. Furthermore, restrict direct container port exposure to the host loopback interface and use Docker volume mounts to persist configuration settings safely. Regularly pull the latest container image tags to patch underlying Java dependencies and maintain system security.

Stirling PDF is architected as a Spring Boot Java application that orchestrates several industry-standard open-source command-line tools and libraries. For core PDF structural manipulation, it relies heavily on Apache PDFBox and PDFClown for reading, writing, and modifying object streams. Document format conversions leverage headless LibreOffice instances to parse complex office suites, while optical character recognition relies on Tesseract via the OCRmyPDF wrapper. Image manipulation tasks utilize Ghostscript and ImageMagick to handle compression, scaling, and color space transformations.

You can automate document workflows by leveraging the built-in Swagger REST API endpoints exposed by your running instance at port 8080. Using a standard curl command, you can send a multipart form-data POST request to the merge endpoint with your files. For example, execute 'curl -X POST 'http://localhost:8080/api/v1/general/merge' -F 'fileFiles=@doc1.pdf' -F 'fileFiles=@doc2.pdf' --output result.pdf' to receive the combined file directly in your terminal. This enables seamless integration into automated backup pipelines, CI/CD report generators, and cron-scheduled batch tasks.

The fundamental difference lies in data sovereignty, hosting architecture, and privacy enforcement. Cloud converters like Smallpdf require you to upload your confidential files to their commercial servers, where they reside temporarily and may be subject to third-party data logging or corporate data mining policies. Stirling PDF runs entirely on your own local machine or private server infrastructure using Docker, meaning your files never traverse the public internet or touch third-party storage. Additionally, Stirling PDF is entirely free and open-source under the GPL-3.0 license, whereas cloud competitors charge recurring monthly subscription fees and impose strict monthly usage caps.

A Java OutOfMemoryError occurs when the default Java Virtual Machine heap allocation is exceeded while Apache PDFBox attempts to load large, highly complex vector graphics or multi-hundred-page scanned documents into memory. To resolve this, you must increase the maximum heap size allocated to the container by passing the JVM argument '-Xmx4g' via the JAVA_OPTS environment variable in your Docker Compose file. For extreme workloads involving multi-gigabyte files, consider splitting the source document into smaller chunks before processing them individually through the application.