PRPDF

PRPDF is a lightweight, self-hosted web app for previewing, renaming, and archiving scanned PDF (Portable Document Format) documents.

  • Productivity
  • Tools & Utilities
PRPDF is a lightweight, self-hosted web app for previewing, renaming, and archiving scanned PDF (Portable Document Format) documents. It watches a source folder and automatically scans, OCR (optical character recognition) processes, merges, renames, and moves new files into your archive folder, with optional AI-assisted renaming. It is aimed at homelab users who want a simple rule-based autoscan alternative to full document-management systems like Paperless-ngx, while keeping files in a normal folder structure with no database. PRPDF is currently in open beta.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

49/100 Fair

Maintained
68last commit 76 days ago
Popular
2516 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
1016 GB minimum RAM
Security check
85no serious findings, CI

Availability: platform listings confirmed today, links checked 37 days ago

GitHub stars
16
Open issues
1
Last commit
2026-09-06
Latest release
1.0.2
License
MIT
Activity
stale

Checked 10 days ago - source: GitHub (maschhoff/prpdf)

Resources & Compatibility

Minimum requirements: 16 GB RAM. ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Setup Add a source folder for incoming scans and a separate target archive folder; processed files are sorted and archived into the existing subfolders of the target folder. source

Fetched 44 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I expose PRPDF when running it in Docker?

Use a port mapping such as -p 80:80. You can choose any host port, but the port in the app configuration must match the mapped container port.

Which folders should I mount for a Docker deployment?

Mount your archive folder to /Archiv, the scan source folder to /source/static/pdf, and the app data/config folder to /source/config. The archive folder should contain the subfolders where recognized documents are sorted.

Where do unrecognized scanned PDFs go after autoscan?

Files that autoscan does not recognize are moved to the unknown subfolder of the scan folder. The web interface lists the documents in that unknown folder for manual handling.

How can I run a newer development build of PRPDF?

Use the Docker image knex666/latest-dev instead of the regular image. This is the developer preview image.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads