Frequently asked questions

Q: I’m using docker. Where are my documents?

A: Your documents are stored inside the docker volume paperless_media. Docker manages this volume automatically for you. It is a persistent storage and will persist as long as you don’t explicitly delete it. The actual location depends on your host operating system. On Linux, chances are high that this location is



Dont mess with this folder. Don’t change permissions and don’t move files around manually. This folder is meant to be entirely managed by docker and paperless.

Q: Will paperless-ng run on Raspberry Pi?

A: The short answer is yes. I’ve tested it on a Raspberry Pi 3 B. The long answer is that certain parts of Paperless will run very slow, such as the tesseract OCR. On Rasperry Pi, try to OCR documents before feeding them into paperless so that paperless can reuse the text. The web interface should be alot snappier, since it runs in your browser and paperless has to do much less work to serve the data.


Consider setting PAPERLESS_OPTIMIZE_THUMBNAILS to false to speed up the consumption process. This takes quite a bit of time on Raspberry Pi.


Updating the automatic matching algorithm takes quite a bit of time. However, the update mechanism checks if your data has changed before doing the heavy lifting. If you experience the algorithm taking too much cpu time, consider changing the schedule in the admin interface to daily or weekly. You can also manually invoke the task by changing the date and time of the next run to today/now.

The actual matching of the algorithm is fast and works on Raspberry Pi as well as on any other device.

Q: How do I install paperless-ng on Raspberry Pi?

A: There is not docker image for ARM available. If you know how to build that automatically, I’m all ears. For now, you have to grab the latest release archive from the project page and build the image yourself. The release comes with the front end already compiled, so you don’t have to do this on the Pi.