# PRPDF

PRPDF is a lightweight, self-hosted web app for previewing, renaming, and archiving scanned PDF (Portable Document Format) documents. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1761/prpdf

## Description

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.

## Health score

49/100 (Fair), based on 5 of 5 factors.
- Maintained: 68 (last commit 76 days ago)
- Popular: 25 (16 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (16 GB minimum RAM)
- Security check: 85 (no serious findings, CI)

## Links

- Docker Hub: https://hub.docker.com/r/knex666/prpdf
- Unraid: https://ca.unraid.net/apps/prpdf-1we0b2f1cj5bub?q=PRPDF

## 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.

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