# Stirling-PDF | Stirling Tools | Knowledge Base | Instagit

#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere

GitHub Stars: 74.7k

Repository: https://github.com/Stirling-Tools/Stirling-PDF

---

## Articles

### [How to Implement Audit Logging for Compliance Using the AuditAspect in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-to-implement-audit-logging-for-compliance-using-the-auditaspect)

Implement audit logging for compliance in Stirling-PDF using AuditAspect. Persist structured compliance records with configurable granularity using AOP and Spring Actuator.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Handle Memory Management for Processing Large PDF Files (100GB+) in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-to-handle-memory-management-for-processing-large-pdf-files-100gb)

Learn how Stirling-PDF handles 100GB+ PDF files without running out of memory. Discover techniques like worker isolation and LRU cache management.

- Tags: performance
- Published: 2026-03-01

### [How to Run the Stirling-PDF Test Suite Using the test.sh Script](/Stirling-Tools/Stirling-PDF/how-to-run-the-test-suite-using-the-test-sh-script)

Learn how to run the Stirling-PDF test suite using the test.sh script. This guide covers building Docker images and validating the application across multiple configurations for robust testing.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Customize the UI Theming in Stirling-PDF Using the @app Import Path Pattern](/Stirling-Tools/Stirling-PDF/how-to-customize-the-ui-theming-using-the-app-import-path-pattern)

Easily customize Stirling-PDF UI theming with the @app import path pattern. Override Mantine themes for consistent styling across web, desktop, and proprietary builds.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Configure Reverse Proxy with Nginx for Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-to-configure-reverse-proxy-with-nginx-for-stirling-pdf)

Configure Nginx as a reverse proxy for Stirling-PDF. Learn to easily set up your Stirling-PDF backend URL for seamless integration and optimal performance.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Deploy Stirling-PDF Using Docker: Complete Guide to Dockerfile Variants](/Stirling-Tools/Stirling-PDF/how-to-deploy-stirling-pdf-using-docker-with-the-various-dockerfile-variants)

Deploy Stirling-PDF using Docker with four optimized image variants Unified Unified-lite Ultra-lite or Fat. Choose the best Dockerfile for your needs and resource constraints.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Implement Digital Signatures Using the CertSignController in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-to-implement-digital-signatures-using-the-certsigncontroller)

Learn how to implement digital signatures with CertSignController in Stirling-PDF. This guide details using the POST endpoint for cryptographically signed documents and visible overlays with Apache PDFBox.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Set Up the Database for Enterprise Audit Features in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-to-set-up-the-database-for-enterprise-audit-features)

Set up your Stirling-PDF database for enterprise audit features easily. Configure settings.yml and let JPA automatically create the audit_events table to track user and system actions.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Configure LibreOffice for Document-to-PDF Conversions in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-to-configure-libreoffice-for-document-to-pdf-conversions)

Configure LibreOffice for PDF conversions with Stirling-PDF. Learn to set up your settings.yml for optimal performance, concurrency, and timeouts.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Implement Custom PDF Processing Using PDFBox in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-to-implement-custom-pdf-processing-using-pdfbox-in-the-codebase)

Learn to implement custom PDF processing in Stirling-PDF using Apache PDFBox. Create Spring services with PDDocument and REST controllers to enhance your PDF workflows.

- Tags: how-to-guide
- Published: 2026-03-01

### [How JobQueue and JobExecutorService Handle Async PDF Processing in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-does-the-jobqueue-and-jobexecutorservice-handle-async-pdf-processing)

Discover how Stirling-PDF's JobQueue and JobExecutorService manage async PDF processing. Learn about resource-aware job management and background thread pools for efficient PDF operations.

- Tags: internals
- Published: 2026-03-01

### [How to Enable or Disable Specific API Endpoints Programmatically in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-to-enable-or-disable-specific-api-endpoints-programmatically)

Dynamically manage Stirling-PDF API endpoint access programmatically. Use the EndpointConfiguration bean to enable or disable endpoints at runtime for instant control.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Add New Translations to the Stirling-PDF UI Using Locale Files](/Stirling-Tools/Stirling-PDF/how-to-add-new-translations-to-the-ui-using-json-locale-files)

Learn how to add new translations to Stirling-PDF UI. Translate TOML locale files by copying the English reference, updating key-value pairs, and running validation scripts before submitting your PR.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Configure Stirling-PDF via YAML Settings Files](/Stirling-Tools/Stirling-PDF/how-to-configure-the-application-via-yaml-settings-files)

Learn to configure Stirling-PDF using YAML settings files. Discover how Stirling-PDF loads application properties from settings.yml for easy customization. Read now.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Create Custom Pipeline Workflows Using the PipelineController in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-to-create-custom-pipeline-workflows-using-the-pipelinecontroller)

Create custom pipeline workflows by POSTing JSON to Stirling-PDFs /api/v1/pipeline/handleData. The PipelineController processes your PDF operations sequentially.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Use Stirling PDF REST API Endpoints for Merge, Split, and Convert Operations](/Stirling-Tools/Stirling-PDF/how-to-use-the-rest-api-endpoints-for-pdf-merge-split-and-convert-operations)

Easily merge, split, and convert PDFs using Stirling PDF REST API endpoints. Learn how to leverage these powerful tools for your document workflows with multipart data requests.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Set Up the Stirling-PDF Local Development Environment with Gradle and npm](/Stirling-Tools/Stirling-PDF/how-to-set-up-the-local-development-environment-with-gradle-and-npm)

Easily set up the Stirling-PDF local development environment. Follow simple steps using Gradle and npm to launch the backend and frontend servers for seamless development.

- Tags: getting-started
- Published: 2026-03-01

### [How to Enable and Use DOCKER_ENABLE_SECURITY in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-does-the-security-mode-docker-enable-security-work-and-how-to-enable-it)

Enable DOCKER_ENABLE_SECURITY in Stirling-PDF to activate Spring Security authentication. Secure your application with login endpoints user management and SSO.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Configure SAML Single Sign-On (SSO) in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-to-configure-saml-single-sign-on-sso-in-stirling-pdf)

Easily configure SAML single sign-on SSO in Stirling-PDF. Secure your application by integrating with IdPs like Keycloak, Okta, or Azure AD for seamless user access. Follow our simple guide for quick setup.

- Tags: how-to-guide
- Published: 2026-03-01

### [How to Configure OAuth2 Authentication in Stirling-PDF: Enterprise SSO Guide](/Stirling-Tools/Stirling-PDF/how-to-configure-oauth2-authentication-in-stirling-pdf)

Configure OAuth2 authentication in Stirling-PDF for enterprise SSO. Easily enable secure logins by setting security.oauth2.enabled true and configuring your identity provider.

- Tags: how-to-guide
- Published: 2026-03-01

### [How the Stirling-PDF Pipeline System Works for Automated PDF Processing Workflows](/Stirling-Tools/Stirling-PDF/how-does-the-pipeline-system-work-for-automated-pdf-processing-workflows)

Discover how the Stirling-PDF pipeline system automates PDF processing workflows. Learn to monitor folders, execute API operations via JSON, and manage output for efficient document management.

- Tags: internals
- Published: 2026-03-01

### [How to Add a New PDF Processing Tool Using the useToolOperation Hook Pattern in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-to-add-a-new-pdf-processing-tool-using-the-usetooloperation-hook-pattern)

Learn to add a new PDF processing tool to Stirling-PDF using the useToolOperation hook pattern. Follow our guide to extend parameters, build forms, and register your operation.

- Tags: how-to-guide
- Published: 2026-03-01

### [How the Multi-Module Gradle Build Works in Stirling-PDF](/Stirling-Tools/Stirling-PDF/how-does-the-multi-module-gradle-build-work-in-stirling-pdf)

Understand the Stirling-PDF multi-module Gradle build. Learn how it manages shared versions, integrates proprietary features, and builds a single runnable JAR.

- Tags: internals
- Published: 2026-03-01