# StirlingPDF

StirlingPDF is a private, self-hosted PDF platform for users who want to merge, split, compress, convert, and run optical character recognition (OCR) on documents while keeping files on their own infrastructure. It is open source and self-hosted, installable on Docker Hub, TrueNAS, Proxmox, Unraid, Umbrel and Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/5330/stirlingpdf

## Description

Stirling PDF is a private, self-hosted PDF platform for users who want to merge, split, compress, convert, and run optical character recognition (OCR) on documents while keeping files on their own infrastructure.

## Platform availability

Available on 10 of 10 platforms: Unraid, TrueNAS, Umbrel, ZimaOS, Proxmox, Helm, Mac, Windows, Linux, Any server.

## Desktop and other devices

Mac, Windows, Linux.

## Health score

91/100 (Excellent), based on 4 of 4 factors.
- Maintained: 100 (last commit 3 days ago)
- Popular: 100 (96,939 GitHub stars)
- Easy to install: 85 (10 install platforms, install notes, Docker image)
- Light to run: 60 (2 GB minimum RAM, runs on ARM)

## Links

- GitHub: https://github.com/Stirling-Tools/Stirling-PDF
- Docker Hub: https://hub.docker.com/r/stirlingtools
- TrueNAS: https://apps.truenas.com/catalog/stirling-pdf
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=stirling-pdf
- Unraid: https://ca.unraid.net/apps?q=StirlingPDF&app=16mxp8
- Umbrel: https://apps.umbrel.com/app/stirling-pdf
- desktop: https://github.com/Stirling-Tools/Stirling-PDF/releases/latest
- Official website: https://stirling.com
- Kubernetes (Helm): https://artifacthub.io/packages/helm/stirling-pdf/stirling-pdf-chart

## Common questions

### What Docker port and volume should I use for a basic Stirling PDF deployment?

Run the container with port 8080 exposed and mount ./stirling-data:/configs. Without the port you cannot reach the app, and without the /configs mount settings can be lost when the app package is replaced.

### How do I protect a Stirling PDF instance that other devices can reach?

Set security.enableLogin: true and use the login-enabled package or set DISABLE_ADDITIONAL_FEATURES=false. Without a real account, anyone who can reach the port can use StirlingPDF and upload files.

### How do I point the Windows desktop client at a self-hosted Stirling PDF server?

Pass STIRLING_SERVER_URL with your actual address and STIRLING_LOCK_CONNECTION=1 during a winget install. Without STIRLING_SERVER_URL, a silent install may not know where StirlingPDF is running.

### Can self-hosted Stirling PDF be integrated into other workflows?

Yes, REST APIs are available for nearly all tools to integrate into existing systems. The self-hosted server also provides a private API.

### Do self-hosted Stirling PDF tools process files on my instance?

Self-hosted tools process files on your instance. Desktop tools use the local backend where supported, while tools routed to Stirling Cloud or a connected server send their inputs there.

## Alternatives

- Adobe Acrobat DC: Create and edit PDFs.
- Adobe Acrobat Reader: View, annotate, and collaborate on PDFs, utilize cloud storage and freehand tools.
- BentoPDF: BentoPDF is a privacy-first, self-hosted PDF toolkit that runs entirely in your browser.
- Foxit PDF Reader: Free, lightweight PDF viewer available on multiple platforms.
- PDF Arranger: Small python-gtk application, which helps the user to merge or split pdf documents and rotate, crop and rearrange their pages using an inte…
- PDF24 Creator: PDF24 Creator is free and feature-filled PDF creation, merging and conversion tool for Windows.
- PDF24 Tools: The Swiss Army Knife for PDFs.
- PDFCreator: PDFCreator is a virtual PDF printer that converts any printable document into a PDF file.
- PDFgear: Read, edit, convert, merge, and sign PDF files across devices, for completely free and without signing up.
- PDFsam Basic: PDFsam Basic is a free and open-source desktop application for splitting and merging PDF files.
- PdfCraft: PdfCraft is a fast, native, open-source PDF workbench for users who want to read, organize, combine, split, and secure PDFs locally without…
- Sejda: Sejda helps with your PDF tasks: edit existing text, split, merge, extract, compress, export to other formats and more.

---
Source: Our Local Host (https://ourlocalhost.com/app/5330/stirlingpdf), the self-hosted and open-source app directory.
