Scanbutler
Scanbutler is a self-hosted Docker container that turns scanned paper into searchable PDFs, one per document, named by topic and date.
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
Variants
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