Back to Glossary
Document Management

Paperless-ngx vs Hazel

Paperless-ngx vs Hazel is a comparison between two different approaches to handling documents on a computer. Paperless-ngx is an open-source, self-hosted document management system that ingests scans, runs OCR, and stores documents in a searchable archive with tags, correspondents, and document types. Hazel is a commercial macOS utility from Noodlesoft that watches folders and applies user-defined rules to move, rename, tag, or otherwise act on files in place.

Looking for a tool?

Sortio does this for you

Describe how you want files organized in plain English. Sortio proposes the moves, you review the plan, then apply. Nothing moves until you approve it, and any sort can be undone.

Works on Mac and Windows
Preview every move before it happens
One-click undo on any sort
Last updated: 9/8/2026
Document Management

What is Paperless-ngx vs Hazel?

People researching "paperless-ngx vs hazel" are usually trying to answer a single practical question: should documents live inside a dedicated archive, or should they stay as ordinary files in ordinary folders that something tidies automatically? The two tools answer that question differently, which is why a head-to-head comparison is less about features and more about which model fits how you actually work.

Paperless-ngx is a self-hosted document management system, typically run through Docker on a home server, NAS, or spare machine. You feed it scans and PDFs through a consume folder, an email import, or a web upload. It performs OCR on images and non-searchable PDFs, extracts dates, and files each document against metadata such as correspondent, document type, tags, and storage path. Once a document is in the archive, you find it through full-text search in a browser rather than by remembering where you filed it. The originals are preserved alongside the processed versions.

Hazel takes the opposite stance: your folders stay your folders. It runs as a macOS System Settings pane, watches locations you choose, and applies ordered rules when files appear or change. A rule might match a PDF whose text contains a vendor name, rename it with a date pattern, and move it into a client folder. Nothing is imported into a separate database, so every other app on your Mac sees the results immediately. Understanding this split — archive versus in-place automation — is the core of the comparison, and it matters because the wrong model creates friction on every document you handle for years afterward.

How Paperless-ngx vs Hazel works

Paperless-ngx works as a pipeline. A document lands in the consume directory, and the ingestion worker picks it up, runs OCR where the text layer is missing, generates thumbnails and an archived PDF, then applies matching rules to assign tags, correspondents, and document types. Matching can be literal, regular-expression based, or trained on your prior filing decisions. Everything is indexed for full-text search and exposed through a web interface and REST API. Because it is self-hosted, you own the stack: the database, the storage, the backups, and the updates. That control is the appeal, and the maintenance is the cost.

Hazel works as an event-driven rule engine. You point it at folders, define conditions on attributes such as name, kind, date, source URL, Finder tags, or full PDF text, and attach actions like rename, move, sort into subfolders, run a shell script, or import into another app. Rules are evaluated in order per folder, so ordering and specificity determine the outcome. The logic is explicit and predictable, which is exactly what some people want — and it also means you write and maintain every rule yourself, and each new document category tends to require a new rule.

Sortio sits between these approaches. You describe what you want in plain language — for example, "group these scans by client and year" — and Sortio proposes an organization plan for files that remain in your normal folder structure, with optional renaming and Smart Folders for ongoing automation. It can sort by filename and metadata alone, or read file contents when you turn that on. Content analysis only occurs when you explicitly enable the content sorting toggle. Sortio runs on macOS 10.14+, Windows 10/11, and Linux, backs up files before changes so a sort can be reverted, and offers an offline mode; offline mode processes files locally on your device without cloud connectivity.

Benefits of Paperless-ngx vs Hazel

Clarifies the fundamental choice: a searchable document archive versus automation of the folder structure you already use
Paperless-ngx gives you OCR, full-text search, and structured metadata for scanned paper that would otherwise be unsearchable
Paperless-ngx keeps documents on hardware you control, which suits people with strict data-residency preferences
Hazel keeps files in place and visible to every other macOS app, so nothing depends on a server staying online
Hazel's explicit rule ordering makes outcomes predictable and easy to audit when something files incorrectly
Sortio offers a natural-language path for people who want automated sorting without authoring and maintaining rule sets
Sortio runs across macOS, Windows, and Linux desktops, which helps in mixed-platform households and teams
Comparing all three surfaces hybrid setups — an archive for finished records, in-place organization for active work

Paperless-ngx vs Hazel best practices

1
Decide first whether you need retrieval by search or organization by folder; pick the tool that matches, rather than forcing one to do both.
2
Test any document workflow on a copy of a representative folder before pointing it at your full archive.
3
If you self-host Paperless-ngx, set up and verify automated backups of both the database and the document store before you rely on it.
4
Keep rule sets and prompts narrow and specific; broad matches are the usual cause of misfiled documents in any rule-driven system.
5
Enable content-based sorting in Sortio only for folders where filenames are uninformative, and review the proposed plan before applying it.
6
Revisit your setup after a few months of real use and prune rules or prompts that no longer match the documents you actually receive.

Common Paperless-ngx vs Hazel challenges and solutions

Challenge:

Paperless-ngx requires ongoing infrastructure work — Docker, storage, updates, and backups — which is more than some people want to take on for personal paperwork.

Solution:

Be honest about your appetite for maintenance. If you mainly need documents named and filed sensibly rather than indexed and searchable, a desktop tool such as Hazel or Sortio avoids running a server entirely.

Challenge:

Hazel is macOS-only, so its rules do not carry over to Windows or Linux machines in the same household or team.

Solution:

For mixed-platform setups, choose a tool that ships on each platform you use. Sortio supports macOS, Windows, and Linux desktop, so the same organization approach applies across machines.

Challenge:

Rule-based systems need a new rule for every new document category, and rule sets grow difficult to reason about over time.

Solution:

Document what each rule is for, order them from most to least specific, and consider a natural-language approach for the long tail of documents that do not justify a dedicated rule. AI-powered sorting learns from your preferences; results may vary by file type and complexity.

Challenge:

Moving documents into an archive can make them harder to reach from apps that expect plain files in folders.

Solution:

Keep active working documents in your normal folder structure and reserve the archive for records you have finished with, so day-to-day access stays simple.

How Sortio handles Paperless-ngx vs Hazel

Sortio applies the ideas behind paperless-ngx vs hazel directly: describe how you want files organized in plain English and it sorts, renames, and files them for you, with a preview before anything moves and one-click undo after. The free tier includes a one-time AI trial allowance, and rule-based sorting is free and unlimited.

Download Sortio Free

Frequently Asked Questions

What is the main difference between Paperless-ngx and Hazel?

Paperless-ngx is a self-hosted document management system that imports documents into a searchable archive with OCR and metadata. Hazel is a macOS utility that leaves files where they are and applies your rules to rename, move, or tag them automatically. One is about finding documents by search; the other is about keeping folders tidy.

Can I use Paperless-ngx and Hazel together?

Yes, and many people do. A common pattern is to let Hazel watch a scanner output folder, apply a first pass of renaming and filtering, then drop qualifying documents into the Paperless-ngx consume directory for OCR and archiving. Hazel handles the intake stage, and Paperless-ngx handles long-term retrieval.

Does Hazel run on Windows or Linux?

No. Hazel is a macOS-only utility distributed by Noodlesoft. Paperless-ngx, being self-hosted and typically run in Docker, can be hosted on Linux, Windows, or macOS, and is accessed through a web browser from any desktop on your network.

Where does Sortio fit in this comparison?

Sortio is a desktop app that organizes files in place using natural-language prompts instead of hand-written rules or a hosted archive. You describe the structure you want, review the proposed plan, and apply it, with optional renaming and Smart Folders for ongoing sorting. It runs on macOS, Windows, and Linux, and backs up files before changes so a sort can be reverted.

Do these tools read the contents of my documents?

Paperless-ngx runs OCR on everything it ingests, since search is the point. Hazel can match on PDF text when a rule asks it to. In Sortio, content analysis only occurs when you explicitly enable the content sorting toggle; otherwise it works from filenames and metadata. Offline mode processes files locally on your device without cloud connectivity.

How much does each option cost?

Paperless-ngx is open source and free to run, though you cover the hardware, storage, and time to maintain it. Hazel is a commercial macOS app sold by Noodlesoft; check their site for current terms. Sortio offers a free trial and paid plans; see the pricing page (/pricing) for current details.

Related Terms