Scanbutler

Scanbutler is a self-hosted Docker container that turns scanned paper into searchable PDFs, one per document, named by topic and date.

  • Productivity
  • Tools & Utilities
Scanbutler is a self-hosted Docker container that turns scanned paper into searchable PDFs, one per document, named by topic and date. The Stacks input splits large scans (hundreds of pages, no separator sheets) into documents by content. The Scanner input takes files from a document scanner, one document per file, and gives them the same OCR and naming. Uses Mistral OCR (batch API) and a Mistral chat model; the text layer comes from a fresh Tesseract pass. No web UI: progress is in the container log, and a review.md per stack in the Work folder lists uncertain splits. An optional third input only adds the text layer and uploads to Paperless-ngx. Optionally reports the queue to a webhook such as Home Assistant. Needs a Mistral API key.

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.

52/100 Fair

Maintained
82last commit 24 days ago
Popular
61 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
701 GB minimum RAM

Availability: platform listings confirmed today

GitHub stars
1
Open issues
3
Last commit
2026-10-28
Latest release
v1.7.4
License
MIT
Activity
rising

Checked 23 days ago - source: GitHub (Tom-Joad/scanbutler)

Resources & Compatibility

Minimum requirements: 1 GB RAM.

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

First-install notes

  • Mistral API Key Required Set a Mistral AI API key in the container environment before first run; Scanbutler uses Mistral's batch OCR API and a chat model for document analysis and splitting. source
  • Inputs Configure watched input folders for Stacks, Scanner, and optional text-only Paperless uploads before starting the container. source
  • Running without a web UI Scanbutler has no browser interface. Track progress in the container log and open each stack’s Work/review.md file to review uncertain document splits. source

Fetched 11 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How can I install Scanbutler on Unraid?

Install it from Community Apps on an Unraid server. The Unraid app page lists it as Scanbutler for Unraid.

Does Scanbutler have a web UI?

No, there is no web UI. Progress is shown in the container log, and a review.md file per stack in the Work folder lists uncertain splits.

Can Scanbutler send processed documents to Paperless-ngx?

Yes, an optional third input can add a text layer and upload files to Paperless-ngx.

Can Scanbutler notify Home Assistant?

Yes, it can optionally report the queue to a webhook such as Home Assistant.

What external service does Scanbutler need for OCR and naming?

It uses Mistral OCR and a Mistral chat model, so it needs a Mistral API key. Tesseract provides a fresh text layer.

Answers sourced from ca.unraid.net, github.com

Community

Collected 44 days ago - public community threads