DumbMonit
Monitor Paperless-ngx with DumbMonit
Redis, Celery, search index and classifier health, failed imports, updates, disk space, document count.
DocumentationOfficial website: Paperless-ngx
Product descriptions are in English, as in the product. The page labels follow your language.
What DumbMonit watches
Whether Paperless-ngx still imports what it is sent: the health of its database, Redis, Celery workers, search index, classifier and sanity check, failed tasks, updates, disk space and the number of documents.
Typical use. Documents: Redis, Celery, index, failed imports, updates
Examples
- Paperless-ngx
How it connects
What you need
- API token (recommended)The token of the dedicated dumbmonit user, sent as "Authorization: Token …".
- User name / passwordThe dedicated dumbmonit user itself, sent as HTTP basic authentication.
Network ports to open
8000/TCPAPI (HTTP, default)443/TCPOnly with the https scheme behind a reverse proxy
Setup steps: Create a read-only user in Paperless-ngx
In Paperless-ngx, open Settings → Users & Groups → Add user and name it as follows, with a long random password.
dumbmonitLeave Superuser and Staff off, and give it only the permissions listed below.
Log in as that user, open the user menu → My Profile and generate its API token (circular arrow button).
In DumbMonit, enter Paperless-ngx's address and paste the token.
Heads-up. When Redis or Celery stops, Paperless keeps serving its pages and documents, but nothing new is imported, from the consume folder or from mail, until someone looks. DumbMonit alerts on both.