Docspell is live · free · last verified 25 Oct 2026 · viability monitor
Docspell
Open-source, self-hosted document organizer that OCRs scans and mail and proposes metadata so you stop building folder trees.
Choose Docspell if you want a document store you can script and extend rather than click through. The REST/HTTP API covering every web-UI feature, the addon system for custom document processing, and the optional PostgreSQL search index are concrete reasons to pick it over simpler self-hosted DMS options. Be honest about the trade: it is a multi-component system — REST server, JOEX, optional Solr or PostgreSQL index — that you administer and scale yourself, and its metadata proposals need curating. If you mainly want to ask questions of your documents, Docspell does not do that.
Verdict generatedVerified 5d ago · liveness 65/100 · cite: rightaichoice.com/tools/docspell
- Home users who want scanner and email documents organized automatically on their own server
- Small and medium organizations needing a self-hosted DMS without folder hierarchies
- Developers who want a document store they can drive from scripts, curl and the REST API
- Privacy-conscious households or teams that already run Docker or Nix
- Users who want to chat with or summarize documents using an LLM
- Non-technical users who only want a GUI and no server administration
- Enterprises that require vendor support contracts
We scan live Reddit threads, YouTube comments, X posts, G2 reviews and other communities — and hand you an honest verdict in under a minute.
- Honest verdict, not marketing
- Real pros & cons from real users
- Attributed quotes with receipts
3 free scans · no card needed
Skip Docspell if you want to ask questions of your archive in natural language or need a vendor to run and support the system for you, rather than maintaining a REST server, JOEX worker and optional search index yourself.
The server bill is yours: Docspell is free software but you pay for the box, storage for originals plus generated PDFs, and backups of both.
Docspell is AGPLv3+ open source with no licence fee, so the comparison is against your hosting and admin time rather than a per-seat subscription. It sits well with a household or small organization already running Docker or Nix that wants to avoid recurring DMS costs; against a vendor-hosted paid DMS, you are trading subscription spend for a server, storage and the hours to keep components patched.
In short
Docspell — Open-source, self-hosted document organizer that OCRs scans and mail and proposes metadata so you stop building folder trees. Best for Home users who want scanner and email documents organized automatically on their own server, Small and medium organizations needing a self-hosted DMS without folder hierarchies, Developers who want a document store they can drive from scripts, curl and the REST API. Free to use.
What is Docspell?
Docspell — Open-source, self-hosted document organizer that OCRs scans and mail and proposes metadata so you stop building folder trees. Best for Home users who want scanner and email documents organized automatically on their own server, Small and medium organizations needing a self-hosted DMS without folder hierarchies, Developers who want a document store they can drive from scripts, curl and the REST API. Free to use.
Docspell is an AGPLv3+ document organizer you run on your own hardware. You drop in files from scanners, IMAP mailboxes or scripts, and it converts every item to PDF while keeping the untouched original downloadable. Tesseract handles OCR on scans and image-heavy input, and Docspell then runs text analysis over the extracted text to propose the metadata that actually comes out of a document: correspondent, concerned person or thing, item date, due date and tags. Its own docs are explicit that for correspondents and dates it proposes a few candidates and sets the most likely one, which may be wrong — you are expected to curate. Searching covers full text plus names, notes, tags, correspondent and tag category, backed by either Apache Solr or PostgreSQL as an optional search index. Email runs both ways: scheduled IMAP import (with move-or-delete after import) and SMTP send with address-book completion. ZIP and EML files are unpacked and their contents imported. Accounts are collectives — multiple users sharing one document pool with separate settings — which suits a household or a small organization. Notifications go out by email, Matrix or Gotify, for events or for a periodically executed query. The system is componentized into a REST server, a JOEX job executor for long-running work, and the optional index; you scale by starting more instances against one shared database, and everything the Elm web UI does is reachable over the REST/HTTP API. The intended audience is home users and small-to-medium organizations who want control instead of a hosted service, and who are comfortable running Docker or Nix.
Key features
- OCR text extraction via tesseract on scanned documents and images
- Text analysis proposing correspondent, concerned person, dates and tags, with candidate lists
- Every file converted to PDF while the untouched original stays stored and downloadable
- Searchable PDF output when converting image data from scanners
- Full-text search backed by Apache Solr or PostgreSQL (optional component)
- Scheduled IMAP mailbox import with move-or-delete after import
- Send items via email with SMTP settings and address-book completion
- ZIP and EML unpacking with contents imported as documents
- Custom fields, folders and markdown notes for extra metadata
- Tags with categories for grouping document types such as bill or receipt
- Folders with per-user membership that restrict item visibility
- Multi-user collectives sharing one document pool with separate user settings
- Two-factor authentication
- REST/HTTP API exposing every web-UI feature, driven by curl or your own scripts
- JOEX job executor and job queue for long-running background processing
Behind the verdict
Docspell's design thesis is the most interesting thing about it. Instead of giving you folder hierarchies to build by hand, it keeps everything as one pile and attaches properties that emerge from the document itself — correspondent, concerned person, item date, due date, tags — because those are the parts you can automate. You then apply views on top: all documents from one correspondent, then all tagged invoice. The docs are refreshingly candid that this only works if you curate: for correspondents and dates it proposes a few candidates and pre-selects the most likely, which "might be wrong." Tags are different — it sets every tag it thinks applies. If you accept the curation step, adding a document costs almost no thinking time. What you actually get under the hood: tesseract OCR, automatic conversion of every file to PDF while the original stays stored and downloadable, searchable PDFs when converting image data from scanners, and ZIP/EML unpacking. Folders exist, but with a twist — an item is in exactly one folder or none, and folders can be tied to users so items are only visible to members, which is the access-control mechanism worth understanding before you design a shared setup. Full-text search is optional and sits in a separate component, Apache Solr or PostgreSQL; skip it and you run a lighter stack. Email is treated as a first-class source. Scheduled IMAP import pulls mailboxes and can move or delete mail after import; SMTP settings let you send items back out with address-book completion; notifications reach you through email, Matrix or Gotify, either on events or on a query you schedule. Programmers get a REST/HTTP API that exposes everything the web UI does — the web app itself is an Elm SPA over that API — plus a CLI client, an Emacs client and a community Android client. Operationally this is infrastructure, not an app. The REST server serves the API and UI, JOEX does the long-running work like file processing and periodic mail import, and scaling means more instances of both pointed at one shared database. Setup is expected to go through Docker, Nix/NixOS, or a manual install. There is two-factor authentication and a registration and base-URL configuration surface, so it can be exposed sensibly, but DNS, reverse proxy, backups and upgrades are yours. Where it doesn't fit: anyone who wants an AI assistant over their archive — Docspell's analysis proposes metadata fields, it does not answer questions or summarize. Anyone who wants a vendor contract or a polished mobile-first experience. Anyone unwilling to maintain several processes. And arguably the biggest gap: the automated metadata is a suggestion you maintain by hand, so the value scales with how much curating you're willing to do.
Limitations
- There is no AI chat or summarization — the text analysis proposes metadata fields, it does not answer questions about your documents.
- Docspell's own documentation says the extracted metadata 'must be maintained manually in the application', and for correspondents and dates it pre-selects the most likely of several candidates, which may be wrong; plan on curating.
- Full-text search is an optional separate component, so you run Apache Solr or PostgreSQL alongside the REST server and JOEX, and you scale by starting multiple instances that must all share one database.
- The web UI is an Elm SPA and a community Android client is mentioned, but there is no first-party mobile app.
- Setup goes through Docker, Nix/NixOS or a manual install, and reverse proxy, backups and upgrades are your responsibility.
as of 2026-10-20
Researching Docspell? Get your full AI stack in 60 seconds.
Free, no signup — tell us your goal and get tools matched to your budget & existing stack.
Is Docspell still active?
Docspell is live · free · last verified 25 Oct 2026 · viability monitor.
Viability score
How well maintained and how widely used is Docspell? Built from what the vendor actually publishes (docs, changelog, tutorials, integrations, pricing), whether the site is live, and how much real users discuss it. How we calculate this
Last calculated: October 2026
How we score →What do users say about Docspell?
What people actually say about Docspell — is it worth it?
We ran a structured research pass across product reviews, community discussions, and post-purchase forum threads to surface the patterns vendors won't publish themselves. Below: the recurring strengths, the hidden costs people mention most, and the cohort that consistently regrets adopting this tool.
Researched27 mentions across 2 sources (YouTube, GitHub) · researched Aug 29, 2026.
Average across the 2 sources that answered — each source counts once, not each post.
- +Powerful automatic metadata extraction (correspondent, date, tags) via OCR and NLP
- +Full-text search across scans using Solr or PostgreSQL
- +Addon system allows custom processing pipelines
- +REST API enables scripting and integration with other tools
- +Mailbox scanning and email import automate document capture
- −OCR processing can hang or fail unpredictably, blocking ingestion
- −Database migrations have broken installations on upgrade
- −OIDC setup with providers like Authentik is error-prone
- −Fulltext search with Solr has known errors and configuration issues
- −Steep learning curve for deployment and configuration
- • Time and effort for setup, integration, and troubleshooting
- • Possible costs for cloud hosting or dedicated hardware
How we verified this
Every listed fact about Docspell— pricing, features, links, status — is re-read from the vendor's own pages by our verification pipeline and each change is logged with a date; the last pass ran on 25 Oct 2026. Pages mix model-assisted synthesis with human review; see how we verify.
Verification history
We have re-verified Docspell 14 times since . Each pass re-reads the vendor's own pages and re-checks every listed field against that evidence; passes where nothing had changed are marked as such.
- — changed SSL certificate
- — changed our verdict, setup time, switching out, pricing fit, who should skip it, switching in, summary, features, hidden costs, integrations, use cases, who it suits, limitations, description, pricing tiers
- — changed who should skip it, our verdict, summary, pricing tiers, who it suits, integrations, features, description
- — changed setup time, who it suits, description, our verdict, features, hidden costs, integrations, limitations, switching in, switching out, who should skip it, pricing tiers, pricing fit, summary, use cases
- — changed switching in, integrations, setup time, hidden costs, summary, who should skip it, features, switching out, description, pricing fit, our verdict
- — changed SSL certificate, domain expiry
Showing the 6 most recent of 14 verification passes.
Free to cite with attribution — this page re-verifies continuously.
How much does Docspell cost in 2026?
Docspell: Free to use. Pricing last verified 25 Oct 2026.
Plans compared
Every published Docspell tier, its price as the vendor publishes it, who it fits, and what it adds over the tier below. The 12-month cost projection follows.
| Plan | Price | Billing | Who it's for |
|---|---|---|---|
| Self-hosted (Open Source) | Free | — | Home users, small organizations and developers who already run Docker or Nix and want to own the document store and its data.Adds: Free entry point under AGPLv3+: no licence fee, your own server and storage, with OCR, text analysis, IMAP/SMTP and the REST API included. |
12-month cost
Project the real annual outlay, including the implied monthly cost when only an annual tier is published.
Vendor list price only. Add-on usage, seat overages, and contract minimums are surfaced under Hidden costs & gotchas.
Where the pricing makes sense
The company stage and team size where Docspell's pricing actually pencils out — and where peers do it cheaper.
Docspell is AGPLv3+ open source with no licence fee, so the comparison is against your hosting and admin time rather than a per-seat subscription. It sits well with a household or small organization already running Docker or Nix that wants to avoid recurring DMS costs; against a vendor-hosted paid DMS, you are trading subscription spend for a server, storage and the hours to keep components patched.
Has Docspell's pricing changed?
No plan price for Docspell has moved since we began logging in Aug 2026; the pricing page is re-read on every verification pass.
Who should pick Docspell?
Pick Docspell if you are Home users who want scanner and email documents organized automatically on their own server, Small and medium organizations needing a self-hosted DMS without folder hierarchies, Developers who want a document store they can drive from scripts, curl and the REST API, Privacy-conscious households or teams that already run Docker or Nix.
Look elsewhere if you are Users who want to chat with or summarize documents using an LLM, Non-technical users who only want a GUI and no server administration, Enterprises that require vendor support contracts, Teams expecting a heavily polished native mobile app as the primary interface.
Skip it if Skip Docspell if you want to ask questions of your archive in natural language or need a vendor to run and support the system for you, rather than maintaining a REST server, JOEX worker and optional search index yourself.
GeneratedReal-world workflow fit
Concrete scenarios for the personas Docspell actually fits — and what changes day-one when you adopt it.
Point the scanner's output folder at Docspell, let it OCR each PDF and propose correspondent, date and tags, then click through a short curation list each week.
Outcome: A searchable archive of bills and contracts where you search by correspondent or tag instead of rebuilding a folder tree.
Set up one collective with an account per colleague, put sensitive items in member-only folders, and import a shared invoices mailbox over scheduled IMAP with move-after-import.
Outcome: Everyone sees the shared pool, sensitive folders stay restricted, and incoming invoices are filed without anyone dragging files around.
Upload documents from a script against the REST/HTTP API, write an addon for custom processing, and have JOEX handle the long-running jobs.
Outcome: Docspell becomes the storage and OCR layer under your own tooling rather than a separate app you log into.
Use cases
- Let scanner output land in a watched folder and get OCR'd, dated and tagged automatically
- Import invoices and receipts arriving as email attachments from an IMAP mailbox on a schedule
- Keep a searchable personal archive of contracts, bills and letters without building folder trees
- Get a notification by email, Matrix or Gotify when a scheduled query finds new matching documents
- Script bulk uploads and lookups from your own tools against the REST API
- Share one document pool among family or colleagues while each user keeps their own settings
- Restrict sensitive items to specific users by putting them in member-only folders
- Send a document back out by email with SMTP and address-book completion
Setup time & first value
How long it actually takes to get something useful out of Docspell — broken out by persona, not the marketing-page minute.
Home Docker user: an evening to bring up the REST server and JOEX via docker-compose, register a collective, and import a first batch. Nix/NixOS user: faster if you already manage services declaratively. Adding Solr or PostgreSQL full-text search and a reverse proxy with TLS pushes it into a second session. Non-technical users should budget days, not hours.
Switching to or from Docspell
How to bring data in from common predecessors and how to get it back out — written for the switcher, not the buyer.
- →From a folder-based DMS: upload the files, let OCR and text analysis propose correspondent and tags, then curate rather than rebuilding the hierarchy.
- →From Paperless: Docspell's documentation includes a Paperless import tool, so existing documents and metadata come across rather than being re-uploaded by hand.
- ↗To a hosted DMS: download items through the web UI or pull them from the REST/HTTP API, since originals are stored and downloadable alongside the generated PDFs.
Integrations
Resources & guides
- Documentationdocspell.org
Docs · Docspell
Full product docs from docspell.org
- Documentationdocspell.org
Docker · Docspell
Full product docs from docspell.org
- Documentationdocspell.org
Nix · Docspell
Full product docs from docspell.org
- API Referencedocspell.org
Api · Docspell
Methods, params, types from docspell.org
- Documentationdocspell.org
Addons · Docspell
Full product docs from docspell.org
- API Referencedocspell.org
Cli · Docspell
Methods, params, types from docspell.org
- Documentationdocspell.org
Faq · Docspell
Full product docs from docspell.org
Tutorials & Learning
YouTube returned 6 videos for “Docspell”, and we withheld 6: 6 could not be judged, because “Docspell” is a single word that other videos use for other things. We are showing none, because we could not prove any of them are about Docspell.
Official links
What are the best Docspell alternatives?
The closest alternatives to Docspell we list are Rapid AI, DeepSeek-OCR and Airparser. Ranked by direct product-type match, not category overlap.
| Alternative | Pricing | Starts at | Last verified |
|---|---|---|---|
| Rapid AI | Free | Free | — |
| DeepSeek-OCR | Freemium | Pricing not published | — |
| Airparser | Freemium | Pricing not published | — |
Alternatives to Docspell
View all
Rapid AI
Open-source AI engineering org shipping self-hosted OCR, ASR and table-recognition components you deploy yourself.
DeepSeek-OCR
Open-source, MIT-licensed OCR model that compresses page images into vision tokens for cheaper long-document inference.
Tools that pair well with Docspell
Common stack mates teams adopt alongside Docspell, with the specific reason each pairing earns its keep.
Rapid AI
Open-source AI engineering org shipping self-hosted OCR, ASR and table-recognition components you deploy yourself.
DeepSeek-OCR
Open-source, MIT-licensed OCR model that compresses page images into vision tokens for cheaper long-document inference.
Airparser
Airparser turns emails, PDFs and scans into structured JSON with AI document parsing — no templates to maintain
Docspell vs its closest rival
Docspell's closest head-to-head is with Genspark — If you need a free, self-hosted document organizer that excels at OCR and metadata extraction from scanned documents and emails, choose Docspell. If you want an AI-powered workspace that synthesizes web research into cited summaries, creates slides/sheets/docs, and lets you build custom tools without coding, choose Genspark. They solve different problems: Docspell is about taming your document inbox; Genspark is about accelerating research and content creation. Verdict generated
Head-to-head comparisons
Docspell vs Genspark
If you need a free, self-hosted document organizer that excels at OCR and metadata extraction from scanned documents and emails, choose Docspell. If you want an AI-powered workspace that synthesizes web research into cited summaries, creates slides/sheets/docs, and lets you build custom tools without coding, choose Genspark. They solve different problems: Docspell is about taming your document inbox; Genspark is about accelerating research and content creation.
GeneratedDocspell vs Guesty
Docspell and Guesty do not compete for the same budget or problem, so a buyer should not be choosing between them. If your pain is a growing pile of scanned PDFs and emails that you want tagged, searchable, and self-hosted for free, Docspell is the fit — though you will run and maintain it yourself. If your pain is double bookings, guest messages across Airbnb/Booking.com/Vrbo, and owner reporting, Guesty is the system-of-record, priced by scoped quote with add-ons. Pick the tool that matches your actual workflow; there is no meaningful head-to-head here.
GeneratedDocspell vs Gem
These two products don't compete — they solve entirely different problems for different buyers. If you need a free, self-hosted system to OCR and auto-organize scanned documents and email, Docspell is the pick. If you're running a recruiting team and want AI sourcing, application ranking, fraud detection, and scheduling layered onto your ATS, Gem is the pick — and it's a commercial platform with custom pricing, while Docspell is free but expects you to run the infrastructure.
GeneratedDocspell vs Poke Interaction Co
Pick Docspell if you need a self-hosted, private document management system with OCR and metadata extraction, and you're comfortable with setup. Poke is better if you want an AI assistant that manages your email, calendar, and tasks from within your messaging apps, with integrations like Notion and Oura. They solve entirely different problems, so your choice hinges on whether you need document organization or personal productivity automation.
GeneratedDocspell vs B Rokratt
These tools serve entirely different needs. Pick Docspell if you want a self-hosted document organizer with OCR and metadata extraction for personal or small-team use. Pick Bürokratt if you're an Estonian citizen or e-resident needing AI-driven access to government services. They are not substitutes; your choice depends entirely on your geographical and document workflow requirements.
GeneratedFrequently asked questions
Used Docspell? Help shape our editorial sentiment research.