Stirling-PDF – (almost) perfect tool for editing those damn PDFs that won't let you edit them
Stirling-PDF is an open-source tool that does (almost) everything you might need with PDFs. It's pretty, responsive, and local. In short, it's very nice. And boom, another middle finger goes to Adobe (bleh).
Stirling-PDF is awesome
Stirling-PDF is an open-source tool that does (almost) everything you might need with PDFs. It’s pretty, responsive, and local. In short, it’s very nice.
And boom, another middle finger goes to Adobe (bleh).
What Stirling-PDF can do
Basic operations:
- Merge and split PDFs
- Rotate pages
- Extract specific pages
- Reorder pages
More advanced stuff:
- Convert to/from various formats (Word, Excel, images)
- OCR - text recognition from scanned documents (supports Polish!)
- PDF compression
- Add/remove watermarks
- Digital document signing
- Encryption and password protection
And a few extra treats:
- Add page numbering
- Clean metadata
- Overlay PDFs on each other
- Auto-split by size/number of pages
All of this is packed into a decent, responsive UI that works on both desktop and mobile.
Let me edit you, stupid PDF
I can’t count how many times I had to quickly fix a typo or some invoice data. In those moments, I still have to reach for other tools or (what I do most often) export to Word, fix it, and generate a PDF from scratch.
Self-hosted Stirling-PDF on your VPS
The moment you break free from the chains imposed by a greedy, crappy shared hosting provider is undoubtedly a breakthrough moment in a person’s life.
Suddenly, the entire virtual world stands open before you, and the only limit is your imagination. You feel adrenaline rushing through your veins, and in the distance, you hear the siren song of Linux commands. Time to put on gloves, take off your pants, and type the secret, elven runes ssh…
3 hours and 88 commands later, you close the terminal, go for a walk, and consider becoming a mobile massage therapist.
This hilarious, almost comically genius insertion above has nothing to do with reality, and if you can just read and have seen a terminal at least once, you’ll handle it no problem (especially now, when you basically don’t even have to read because an LLM does everything for you).
And if you’re using a decent VPS provider, it’s even simpler because you already have a lot of things out of the box.
About the VPS setup
For this guide, I’m using a VPS with Docker pre-installed. The beauty of self-hosting on a VPS is that you have full control over your environment - no restrictions, no sharing resources with hundreds of other users, and you can install whatever you want.
The key advantages of running your own VPS:
- It works as it should
- Cost-effective for multiple self-hosted apps
- You learn actual server management skills
- Complete control over your data and privacy
The downside? You need to be comfortable with the terminal and basic Linux commands. But honestly, if you can follow a tutorial, you’re good to go.
Installing Stirling-PDF
The easiest way to self-host Stirling-PDF is using Docker. Make sure your VPS has Docker installed, and let’s get started.
Step by step:
- Log into your server via
ssh - Create a directory and navigate to it:
mkdir -p ~/stirling-pdf && cd ~/stirling-pdf - Create
docker-composefile withnano docker-compose.yml - Paste the config:
services: stirling-pdf: image: docker.stirlingpdf.com/stirlingtools/stirling-pdf:latest container_name: stirling-pdf ports: - '8080:8080' volumes: - ./trainingData:/usr/share/tessdata - ./extraConfigs:/configs - ./customFiles:/customFiles/ - ./logs:/logs/ - ./pipeline:/pipeline/
environment: - DOCKER_ENABLE_SECURITY=false # Disables authentication - only use on private networks - DISABLE_ADDITIONAL_FEATURES=false - LANGS=en_GB,pl_PL restart: unless-stopped- Save and exit
nano:Ctrl+X, Y, Enter - Start the container:
docker compose up -d - If everything went well, you should see something like
Started StirlingPdfApplication
Verification:
Check if Stirling is running with:
curl http://localhost:8080/api/v1/info/statusIf you see something like {"status":"UP"}, we’re good.
Accessing Stirling
I needed Stirling to integrate with n8n, which is hosted on the same VPS. For my needs, passing the endpoint locally was enough: http://localhost:8080/api/v1/convert/pdf/img
If you want to access the panel from your browser, you need to:
- Open a port in your VPS firewall (method depends on your provider)
- Change the port mapping in
docker-compose.yml:
ports: - '40116:8080' # or any other external port you chooseThe pattern is simple: EXTERNAL_PORT:CONTAINER_PORT
Where:
- 40116 (or another) - the port you’ll use to connect from the internet
- 8080 - the internal port where Stirling listens inside the container
- Restart the container:
docker compose downdocker compose up -dNow you can access Stirling via: http://your-server-ip:40116
Summary
Stirling-PDF is a solid PDF tool that you can have on your own server, completely under your control. You spin it up, use it, it works.
Is it perfect? No - the lack of direct text editing hurts. But for everything else, it’s really good. And when you add the fact that you can host it on a cheap VPS, it makes for a pretty nice setup.
Give it a try and see you next time!
Useful links: