How to Install Paperless-ngx on Debian Latest

This tutorial will guide you through the steps of installing Paperless-ngx on Debian latest.

Step 1: Update Your System

Before installing Paperless-ngx, you need to ensure that your system is up to date. Open your terminal and update your system using the following command:

sudo apt update && sudo apt upgrade

Step 2: Install Required Dependencies

Paperless-ngx requires Python3 and several other dependencies to function correctly. Run the following command to install them:

sudo apt install -y python3 python3-pip python3-venv libjpeg-dev zlib1g-dev libmagic-dev tesseract-ocr unpaper strace

Step 3: Create a Virtual Environment

It is recommended to use a virtual environment to install Paperless-ngx on your system. This will help you to isolate the installation from other Python projects on your system. To create a virtual environment, run the following commands:

python3 -m venv ~/paperless
source ~/paperless/bin/activate

Step 4: Install Paperless-ngx

Once you have created your virtual environment, you can install Paperless-ngx using pip. Run the following command to install the package:

pip3 install paperless-ngx

Step 5: Configure Paperless-ngx

After installation, you need to configure Paperless-ngx. Create a new configuration file using the following command:

paperless config edit

You will be prompted to enter the details of your database, email, and other settings. After entering the details, save the configuration file.

Step 6: Run Paperless-ngx

You can now run Paperless-ngx using the following command:

paperless runserver

Open your web browser and navigate to http://localhost:8000 to access the Paperless-ngx web interface.

Conclusion

In this tutorial, you learned how to install Paperless-ngx on Debian latest. You also learned how to create a virtual environment, install dependencies, configure Paperless-ngx, and run it. You can now use Paperless-ngx to manage your documents and receipts.