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,

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