Troubleshooting guide

Paperless-ngx Docker Volume Permission: Fix Denied Upload and Import Access

Category: Document Workflow

Your Paperless-ngx container is running, but uploads fail and the watched import volume is denied, so documents never reach the store.

Confirm the denial is ownership, not a missing mount

Open a shell in the container and list the import and document directories:

docker exec -it paperless-ngx ls -ld /usr/src/paperless/consume /usr/src/paperless/data /usr/src/paperless/media

If the owner UID/GID does not match the user Paperless-ngx runs as, the container cannot read or write. Check the container user with docker exec -it paperless-ngx id. On the host, run ls -ln on the mapped paths. A mismatch such as host 1000:1000 versus container 1001:1001 confirms the paperless ngx docker volume permission problem. Also confirm the volume is actually mounted with docker inspect and that the host path exists.

Correct ownership and test access

Stop the container, then set ownership on the host paths to the container UID/GID. For example, if the container runs as 1001:1001, run sudo chown -R 1001:1001 /path/to/consume /path/to/media /path/to/data. Do not use broad chmod 777 as a permanent fix. Restart the container.

Verification test: create a file inside the container with docker exec -it paperless-ngx touch /usr/src/paperless/consume/test.pdf, then check it appears on the host. Drop a real PDF into the host import folder and confirm it moves into the document store. If the touch succeeds but import still fails, inspect container logs for the exact path being denied.

Rollback and recovery

Before changing ownership, note the original UID/GID. If Paperless-ngx or another service breaks, restore the previous ownership with chown -R olduid:oldgid on the same paths. Keep a backup of the data directory before recursive changes. If the mismatch persists after restart,

A scanned document and Paperless-ngx search result on a laptop

Ask for help with your id output and ls -ln results.


Back to the service page · Ask about this exact symptom