Troubleshooting guide

Paperless-ngx Permission Denied on Docker Import Volume: A Step-by-Step Fix

Category: Document Workflow

You’re running Paperless-ngx in Docker with a watched import volume, but the container reports permission denied when trying to read files or write to the document store. This usually means the user inside the container lacks the necessary filesystem permissions. Let’s diagnose and fix it.

Check container user and volume ownership

First, find the user ID Paperless-ngx runs as. Run docker exec <container_name> id. The output shows a UID and GID (often 1000). Next, check the ownership of your host directories: ls -ln /path/to/import /path/to/data. Compare the numeric owner and group with the container’s UID/GID. If they differ, the container cannot access the files. The fix is to change ownership on the host: sudo chown -R 1000:1000 /path/to/import /path/to/data (replace 1000:1000 with the actual UID/GID from the id command).

Verify permissions and test access

After changing ownership, ensure the directories are readable and writable by the owner: chmod -R u+rwX /path/to/import /path/to/data. Then, test from inside the container: docker exec <container_name> touch /usr/src/paperless/import/testfile. If no error appears, permissions are fixed. Also, drop a test file into the import volume and check the logs for successful consumption.

Rollback and recovery

If you need to revert ownership changes, note the original owner from the earlier ls -ln output and restore it with chown. Always back up your data before making bulk permission changes.

If the paperless ngx permission denied error persists after these steps, there may be underlying issues with volume mounts or SELinux. For personalized assistance,

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

Ask for help.


Back to the service page · Ask about this exact symptom