bettersorted Logo
Technician working on server hardware
Open source & technologies

Installing Paperless-ngx: Guide with Docker for businesses

AuthorMuhamed Alahmed
Published on
Reading time3 min

Image: JESHOOTS.COM / Unsplash

In short

Paperless-ngx is easiest to install with Docker Compose: web server, database (PostgreSQL), Redis, and optionally Tika and Gotenberg for Office files. For a small business, a server with 4 GB of RAM is sufficient. What matters for operation is backups, updates, and a sensible basic structure.

Paperless-ngx is easiest to install with Docker Compose. The installation consists of several containers: the web server of Paperless-ngx, a PostgreSQL database, Redis as a queue and optionally Tika and Gotenberg, so that Word, Excel and email files can also be processed. For a small company, a server with 2 to 4 CPU cores and 4 GB of RAM. The installation is done in an hour – the effort lies in data backup, updates and a solid basic structure.

Building block

Task

Paperless-ngx (web server)

Interface, optical character recognition (OCR), automatic assignment

PostgreSQL

Database for metadata, tags, users

Redis

Queue for background tasks

Tika (optional)

extracts text from Office files and emails

Gotenberg (optional)

converts Office files to PDF

Requirements

  • Linux server or virtual machine, e.g. with a German hoster or in your own network
  • Docker and Docker Compose
  • Storage space for the documents – plan for several times your current scan volume, because both the original and the archived version are stored
  • A domain with HTTPS if external access is required

Installation in six steps

  1. Install Docker and create a folder for Paperless-ngx.
  2. Choose Compose file: The project provides ready-made templates, for example with PostgreSQL and with Tika/Gotenberg. Alternatively, an official installation script guides you through the questions.
  3. Set settings: Time zone, OCR language German (deu), secret key, installation address.
  4. Define folders: for data, media, export, and the input folder ("consume") where scanners or network drives can place files.
  5. Start and create an administrator account.
  6. Set up HTTPS via a reverse proxy before you enable access.

Initial setup: the basic structure

Before the first documents arrive, set up Document types (invoice, contract, delivery note …), important correspondents and some keywords. Then set up email retrieval for the invoice mailbox and initial rules. We show what this looks like Paperless-ngx workflows and Implement Paperless-ngx.

Backup and updates

  • Use the export function:The Paperless-ngx document exporter backs up documents together with metadata in a folder – run it regularly on a schedule.
  • Back up the database: additionally the PostgreSQL database.
  • Second location: store backups encrypted outside the server and test the restore process.
  • Updates:Install new versions promptly, read the release notes beforehand, and create a backup.

Typical errors

  • OCR language not set to German – umlauts are recognized incorrectly.
  • Input folder on a network drive without the appropriate setting – files are not recognized.
  • No backup of the media folder – documents are missing after a crash.
  • Access exposed to the internet without HTTPS.

For tax-relevant documents, this also includes process documentation – see GoBD-compliant filing with Open Source. If you do not want to handle installation and operation yourself, we set up Paperless-ngx on German servers.

Frequently asked questions

What hardware does Paperless-ngx need?

For a small business, 2 to 4 CPU cores and 4 GB of RAM are sufficient. OCR benefits from more cores; memory requirements depend on the volume of documents.

Can I install Paperless-ngx without Docker?

Yes, a manual installation is possible, but it is more complex to set up and update. Docker is the recommended approach.

Do I need PostgreSQL, or is SQLite enough?

SQLite is sufficient for testing. For business use, PostgreSQL is the more robust choice.

How do I back up Paperless-ngx?

With the built-in document exporter, which backs up documents and metadata, plus a backup of the database — encrypted and stored in a second location.

Can Paperless-ngx automatically retrieve emails?

Yes. Paperless-ngx accesses mailboxes via IMAP and imports attachments or entire emails into the archive according to rules.

As of November 2026. Features, licenses, and prices change quickly — the manufacturers’ information is authoritative.

Portrait of Muhamed Alahmed, founder of bettersorted
About the author

Muhamed Alahmed

With over 10 years’ experience in IT, I develop solutions that not only work from a technical perspective, but also create real added value and open up new possibilities.

More about bettersorted →

More articles

Newsletter

Stay up to date on AI topics

Short updates on AI automation, funding programs and new posts — no spam, unsubscribe anytime.

We use Brevo as our marketing platform. By submitting, you agree that your data will be transferred according to Brevo's privacy policy .

CallEmailContact formSEO/GEO Check