One Node.js process instead of Node.js + Python, a much smaller image (~135 MB instead of several GB), a new web interface and much better search in your archive.
⚠️ Security notice for 3.x
In all versions before 4.0, the setup wizard can be used without logging in, which allows anyone who can reach an instance to replace its account and configuration. This is being exploited. Please update. If your 3.x instance was reachable from the internet, read Upgrading from 3.x before you migrate.
Highlights
- Title, tags, correspondent, document type, date and custom fields (incl. long text and select) with structured output
- AI providers: OpenAI, Anthropic (Claude), Ollama, OpenAI-compatible APIs (DeepSeek, OpenRouter, vLLM, LM Studio …) and Azure OpenAI – reasoning/thinking models included
- Ask your archive: hybrid keyword + vector search, streamed answers with cited sources, exact counts for "how many" questions
- History with real undo, manual review, prompt playground, document chat, live dashboard
- Settings are applied instantly – no restart; 3.x environment variables keep working
- Paperless-ngx 2.x and 3.x
Upgrading from 3.x
Keep your data volume and switch the image to clusterzx/paperless-ai:latest (or 4.0.0). Settings, account, processing state, history and token statistics are migrated automatically on the first start; the old files stay untouched. Full steps: Upgrading from 3.x.