RT-Wiki - IT-Notizbuch - Benutzerbeiträge [de]

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-09-16T22:07:17Z

Robin Tönniges:

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS
| Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev)
| Daten3 = 2.18.4
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip python3-setuptools python3-wheel
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv asyncio
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -u paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv asyncio
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>

=== Datenbank ===
'''Hinweis: SQLite kann Probleme beim Bearbeiten paralleler Tasks verursachen.'''

Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight><syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight><syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-09-16T22:06:26Z

Robin Tönniges: /* Frontend */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip python3-setuptools python3-wheel
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv asyncio
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -u paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv asyncio
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>

=== Datenbank ===
'''Hinweis: SQLite kann Probleme beim Bearbeiten paralleler Tasks verursachen.'''

Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight><syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight><syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-04-29T11:20:30Z

Robin Tönniges: /* Datenbank */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip python3-setuptools python3-wheel
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv asyncio
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -u paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv asyncio
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>

=== Datenbank ===
'''Hinweis: SQLite kann Probleme beim Bearbeiten paralleler Tasks verursachen.'''

Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight><syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight><syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-04-29T11:19:50Z

Robin Tönniges: /* Backend */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip python3-setuptools python3-wheel
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv asyncio
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -u paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv asyncio
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>

=== Datenbank ===
'''Hinweis: SQLite kann Probleme beim bearbeiten paralleler Tasks verursachen.'''

Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight><syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight><syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-04-07T20:22:59Z

Robin Tönniges: /* Paperless-ngx installieren */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip python3-setuptools python3-wheel
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv asyncio
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -u paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv asyncio
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight><syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight><syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Log2Ram installieren

2025-03-26T18:30:31Z

Robin Tönniges:

Um auf einem Raspberry Pi die SD Karte zu entlasten, bietet es sich an die Logs aus /var/log/ in den RAM zu schreiben.

Nach der Installation von Log2Ram und einem anschließenden Neustart werden die Logs in den RAM geschrieben und jede Stunde mit den Daten auf der SD Karte synchronisiert.

Zuerst den APT Key und das Repository für Log2Ram hinzufügen und installieren:<syntaxhighlight lang="bash" line="1">
echo "deb [signed-by=/usr/share/keyrings/azlux-archive-keyring.gpg] http://packages.azlux.fr/debian/ bookworm main" | sudo tee /etc/apt/sources.list.d/azlux.list
sudo wget -O /usr/share/keyrings/azlux-archive-keyring.gpg https://azlux.fr/repo.gpg
sudo apt update
sudo apt install log2ram
</syntaxhighlight>Der Programmierer der Software empfiehlt es für eine bessere Performance das Synchronisierungstool '''rsync''' zu installieren: <syntaxhighlight lang="bash">
sudo apt install rsync
</syntaxhighlight>Als nächstes die Config anpassen: <syntaxhighlight lang="bash">
sudo vi /etc/log2ram.conf
</syntaxhighlight>

Größe des RAM-Drives bei Bedarf erhöhen (Standard ist 40MB):<syntaxhighlight lang="bash">
SIZE=128M
</syntaxhighlight>rsync aktivieren:<syntaxhighlight lang="bash">
USE_RSYNC=true
</syntaxhighlight>Neustarten<syntaxhighlight lang="bash">
sudo reboot
</syntaxhighlight>Ob alles wie gewünscht funktioniert kann im Anschluss kontrolliert werden:<syntaxhighlight lang="bash">
df -h
</syntaxhighlight>In der Ausgabe sollte nun stehen das /var/log/ auf dem Filesystem log2ram läuft:<syntaxhighlight lang="bash">
...
log2ram 40M 532K 40M 2% /var/log
...
</syntaxhighlight>

== Quellen ==
https://mcuoneclipse.com/2019/04/01/log2ram-extending-sd-card-lifetime-for-raspberry-pi-lorawan-gateway/

https://github.com/azlux/log2ram
[[Kategorie:Raspberry Pi]]

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-24T00:27:32Z

Robin Tönniges: /* Frontend */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip python3-setuptools python3-wheel
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -u paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight><syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight><syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-24T00:20:38Z

Robin Tönniges: /* Paperless-ngx installieren */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip python3-setuptools python3-wheel
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -u paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-24T00:15:34Z

Robin Tönniges: /* Frontend */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip python3-setuptools python3-wheel
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -u paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-24T00:03:30Z

Robin Tönniges: /* Paperless-ngx installieren */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip python3-setuptools python3-wheel
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -u paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-23T23:57:59Z

Robin Tönniges: /* Paperless-ngx installieren */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip python3-setuptools python3-wheel
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -u paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-23T23:04:51Z

Robin Tönniges:

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip python3-setuptools python3-wheel
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-23T17:40:59Z

Robin Tönniges: /* Quellen */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

== Quellen ==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-23T10:58:21Z

Robin Tönniges: /* Systemd Services anlegen: */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

=== Quellen ===
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-23T10:58:13Z

Robin Tönniges: /* ImageMagick konfigurieren: */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

=== Quellen ===
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-23T10:57:34Z

Robin Tönniges:

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== ImageMagick konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

=== Quellen ===
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-23T10:56:26Z

Robin Tönniges: /* Paperless-ngx installieren */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>

=== Frontend ===
<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>

=== Backend ===
<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

=== ImageMagic konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
==Quellen==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Hauptseite

2025-03-23T10:54:52Z

Robin Tönniges:

== Raspberry Pi ==
[[Proxmox auf Raspberry Pi (Pimox)]]

[[Raspberry Pi Kernel für Proxmox optimieren]]

[[Ceph Cluster mit Raspberry PIs aufbauen]]

[[Log2Ram installieren]]

[[Grafana auf Raspberry Pi installieren]]

[[NGINX installieren (Raspberry Pi)]]

[[Debian 11 auf Raspberry Pi 4 installieren]]

[[Raspberry Pi OS 64 Bit - Upgrade auf Debian 11]]

== Debian/Ubuntu ==
[[MariaDB installieren (Debian/Ubuntu)]]

[[Unifi Network installieren (Debian 11)]]

[[DNS mit BIND]]

[[Paperless-ngx "Bare Metal" installieren (Debian 11/12)|Paperless-ngx von Source installieren (Debian 11/12)]]

== AlmaLinux/CentOS ==
[[Apache installieren (AlmaLinux/CentOS)]]

[[NGINX installieren (AlmaLinux/CentOS)]]

[[Zabbix Server/Agent installieren (AlmaLinux aarch64)]]

[[PowerDNS und PowerDNS-Admin installieren (AlmaLinux/CentOS)]]

[[OpenCMS installieren (AlmaLinux/CentOS)]]

[[SSH Public-Key Login mit PuTTY (AlmaLinux/CentOS)]]

[[PrivacyIDEA installieren (AlmaLinux/CentOS)]]

[[Oracle Database XE installieren (AlmaLinux/CentOS)]]

[[Kubernetes Cluster in Proxmox VE (AlmaLinux/CentOS)]]

== Software ==
[[Apache - SSL Zertifikat installieren]]

[[Reverse Proxy mit NGINX]]

[[MediaWiki mit Varnish Cache und NGINX Proxy]]

----

=== [[Linksammlung]] ===
__KEIN_INHALTSVERZEICHNIS__

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-23T00:25:21Z

Robin Tönniges: /* Quellen */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>Frontend:<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>
Backend:<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

=== ImageMagic konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
==Quellen==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-23T00:10:16Z

Robin Tönniges: /* ImageMagic konfigurieren: */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>Frontend:<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>
Backend:<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

=== ImageMagic konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>
==Quellen==
*[https://wiki.crowncloud.net/?How_to_Install_Python_3_11_on_Debian_11 wiki.crowncloud.net]
*[https://askubuntu.com/questions/1076846/how-to-install-newer-version-of-ghostscript-on-server-than-provided-from-ubuntu askubuntu.com]
*[https://docs.paperless-ngx.com/setup/#bare_metal docs.paperless-ngx.com]
*[https://docs.docker.com/engine/install/debian/ docs.docker.com/]
*[https://gotenberg.dev/docs/getting-started/installation gotenberg.dev]
*[https://hub.docker.com/r/apache/tika hub.docker.com]
===Einzelnachweise===
<references />

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T22:07:01Z

Robin Tönniges: /* Abhängigkeiten installieren */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>Frontend:<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>
Backend:<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

=== ImageMagic konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T22:04:34Z

Robin Tönniges: /* Abhängigkeiten installieren */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev \
libpq-dev libsqlite3-dev libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget imagemagick unpaper \
fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils \
icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel redis git curl

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight>
== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>Frontend:<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>
Backend:<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

=== ImageMagic konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T22:02:25Z

Robin Tönniges: /* Abhängigkeiten installieren */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev \
libnss3-dev libssl-dev libreadline-dev libffi-dev libpq-dev libsqlite3-dev \
libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev wget \

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install imagemagick fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils
sudo apt install unpaper icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel

sudo apt install redis git curl
</syntaxhighlight>

== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>Frontend:<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>
Backend:<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

=== ImageMagic konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:57:25Z

Robin Tönniges:

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev] oder [https://github.com/paperless-ngx/paperless-ngx/tree/beta Beta] Branch auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libpq-dev libsqlite3-dev wget libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install imagemagick fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils
sudo apt install unpaper icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel

sudo apt install redis git curl
</syntaxhighlight>

== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>Frontend:<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>
Backend:<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

=== ImageMagic konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:54:00Z

Robin Tönniges:

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev-Branch] auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libpq-dev libsqlite3-dev wget libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install imagemagick fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils
sudo apt install unpaper icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel

sudo apt install redis git curl
</syntaxhighlight>

== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media

PAPERLESS_TIME_ZONE=Europe/Berlin
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>Frontend:<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>
Backend:<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===

==== stopwords & punkt_tab ====
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>

'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_NLTK_DIR=/opt/paperless/nltk_data
</syntaxhighlight>

==== jbig2enc ====
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
# Tika settings

PAPERLESS_TIKA_ENABLED=true
PAPERLESS_TIKA_ENDPOINT=http://localhost:9998
PAPERLESS_TIKA_GOTENBERG_ENDPOINT=http://localhost:3000
</syntaxhighlight>

=== ImageMagic konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:49:15Z

Robin Tönniges: /* Zusätzliche Pakete installieren */

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev-Branch] auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libpq-dev libsqlite3-dev wget libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install imagemagick fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils
sudo apt install unpaper icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel

sudo apt install redis git curl
</syntaxhighlight>

== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>Frontend:<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>
Backend:<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

==== Tika / Gotenberg installieren (Docker) ====
<syntaxhighlight lang="bash">
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull apache/tika
sudo docker run -d --restart unless-stopped -p 127.0.0.1:9998:9998 apache/tika
</syntaxhighlight><syntaxhighlight lang="bash">
sudo docker pull gotenberg/gotenberg:8
sudo docker run -d --restart unless-stopped -p 127.0.0.1:3000:3000 gotenberg/gotenberg:8
</syntaxhighlight>

=== ImageMagic konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:45:41Z

Robin Tönniges:

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev-Branch] auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libpq-dev libsqlite3-dev wget libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install imagemagick fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils
sudo apt install unpaper icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel

sudo apt install redis git curl
</syntaxhighlight>

== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>Frontend:<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>
Backend:<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung von Dokumenten in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

=== ImageMagic konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:45:01Z

Robin Tönniges:

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = Debian 11.11/12.10
| Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0
}}

Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Sourcecode vom [https://github.com/paperless-ngx/paperless-ngx Dev-Branch] auf Debian 11 und 12.
==Abhängigkeiten installieren==
Das System auf den neusten Stand bringen:<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install build-essential zlib1g-dev libncurses5-dev libgdbm-dev libnss3-dev libssl-dev libreadline-dev libffi-dev libpq-dev libsqlite3-dev wget libbz2-dev pkg-config libgdbm-compat-dev liblzma-dev tk-dev uuid-dev

</syntaxhighlight>
===Python 3.11 installieren===
'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xvf Python-3.11.11.tgz
cd Python-3.11.11
./configure --enable-optimizations
make -j$(nproc)
sudo make install
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install python3.11 python3.11-venv python3-pip
</syntaxhighlight>
===Ghostscript 10.05 installieren===
<syntaxhighlight lang="bash">
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs10050/ghostscript-10.05.0.tar.gz
tar -xvf ghostscript-10.05.0.tar.gz
cd ghostscript-10.05.0
./configure --without-x
make -j$(nproc)
sudo make install
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install imagemagick fonts-liberation gnupg libpq-dev default-libmysqlclient-dev pkg-config libmagic-dev libzbar0 poppler-utils
sudo apt install unpaper icc-profiles-free qpdf liblept5 libxml2 pngquant zlib1g tesseract-ocr python3-setuptools python3-wheel

sudo apt install redis git curl
</syntaxhighlight>

== Paperless-ngx installieren ==
Paperless Benutzer erstellen und Repository klonen:<syntaxhighlight lang="bash">
sudo adduser paperless --system --home /opt/paperless --group
cd /opt/paperless
sudo -Hu paperless git clone https://github.com/paperless-ngx/paperless-ngx.git .
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless mkdir consume media
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless pip3 install uv
sudo -Hu paperless uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless pip3 install -r requirements.txt
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m venv /opt/paperless/venv
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install uv
sudo -Hu paperless /opt/paperless/venv/bin/uv export --no-dev --all-extras --format requirements-txt --output-file requirements.txt
sudo -Hu paperless /opt/paperless/venv/bin/pip3 install -r requirements.txt
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo -Hu paperless cp paperless.conf.example paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_SECRET_KEY=change-me

PAPERLESS_CONSUMPTION_DIR=/mnt/paperless-store/consume
PAPERLESS_DATA_DIR=/mnt/paperless-store/data
PAPERLESS_MEDIA_ROOT=/mnt/paperless-store/media
</syntaxhighlight>Wenn du postgresql statt sqlite verwendet möchtest:<syntaxhighlight lang="bash">
PAPERLESS_DBHOST=127.0.0.1 # Use postgresql
PAPERLESS_DBNAME=db_paperless
#PAPERLESS_DBUSER=paperless
PAPERLESS_DBPASS=<password>
</syntaxhighlight><syntaxhighlight lang="bash">
sudo apt install postgresql
sudo -u postgres psql
</syntaxhighlight><syntaxhighlight lang="sql">
CREATE DATABASE db_paperless;
CREATE USER paperless WITH ENCRYPTED PASSWORD '<password>';
GRANT ALL ON DATABASE db_paperless TO paperless;
\c db_paperless
GRANT ALL ON SCHEMA public TO paperless;
\q
</syntaxhighlight>Frontend:<syntaxhighlight lang="bash">
cd src-ui

</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo curl -sL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo apt install nodejs
sudo apt install npm
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo npm install -g @angular/cli
sudo npm install -g pnpm
sudo -Hu paperless pnpm install

sudo -Hu paperless ng build --configuration production
</syntaxhighlight>
Backend:<syntaxhighlight lang="bash">
cd ../src
</syntaxhighlight>
'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 manage.py migrate
sudo -Hu paperless python3 manage.py createsuperuser
sudo -Hu paperless python3 manage.py collectstatic
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py migrate
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py createsuperuser
sudo -Hu paperless /opt/paperless/venv/bin/python3 manage.py collectstatic
</syntaxhighlight>

=== Systemd Services anlegen: ===
<syntaxhighlight lang="bash">
cd ../scripts
</syntaxhighlight>

==== paperless-consumer ====
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo vi paperless-consumer.service
</syntaxhighlight>ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-consumer.service /etc/systemd/system/paperless-consumer.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-consumer.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-consumer.service

</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-consumer.service - Paperless consumer
Loaded: loaded (/etc/systemd/system/paperless-consumer.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:25:06 CET; 6s ago
Main PID: 6715 (python3)
Tasks: 11 (limit: 9472)
Memory: 97.2M
CPU: 1.518s
CGroup: /system.slice/paperless-consumer.service
└─6715 /opt/paperless/venv/bin/python3 manage.py document_consumer
</syntaxhighlight>

==== paperless-scheduler ====
<syntaxhighlight lang="bash">
sudo vi paperless-scheduler.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless beat --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-scheduler.service /etc/systemd/system/paperless-scheduler.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-scheduler.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-scheduler.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-scheduler.service - Paperless Celery Beat
Loaded: loaded (/etc/systemd/system/paperless-scheduler.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:29:33 CET; 4s ago
Main PID: 6981 ([celery beat] -)
Tasks: 22 (limit: 9472)
Memory: 115.1M
CPU: 1.831s
CGroup: /system.slice/paperless-scheduler.service
└─6981 "[celery beat] --app paperless beat --loglevel INFO"

</syntaxhighlight>

==== paperless-task-queue ====
<syntaxhighlight lang="bash">
sudo vi paperless-task-queue.service
</syntaxhighlight>'''Debian 11:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/.local/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
'''Debian 12:'''
:ExecStart ersetzen:
:<syntaxhighlight lang="bash">
ExecStart=/opt/paperless/venv/bin/celery --app paperless worker --loglevel INFO
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-task-queue.service /etc/systemd/system/paperless-task-queue.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-task-queue.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-task-queue.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-task-queue.service - Paperless Celery Workers
Loaded: loaded (/etc/systemd/system/paperless-task-queue.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:31:23 CET; 4s ago
Main PID: 7122 ([celeryd: celer)
Tasks: 24 (limit: 9472)
Memory: 197.6M
CPU: 2.177s
CGroup: /system.slice/paperless-task-queue.service
├─7122 "[celeryd: celery@paperless-ngx-1:MainProcess] -active- (--app paperless worker --loglevel INFO)"
├─7153 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-1]"
└─7154 "[celeryd: celery@paperless-ngx-1:ForkPoolWorker-2]"

</syntaxhighlight>
==== paperless-webserver ====
<syntaxhighlight lang="bash">
sudo vi paperless-webserver.service
</syntaxhighlight>'''Debian 11:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/.local/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
'''Debian 12:'''
:exec ersetzen:
:<syntaxhighlight lang="bash">
exec /opt/paperless/venv/bin/granian --interface asginl --ws "paperless.asgi:application"'
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo ln -s /opt/paperless/scripts/paperless-webserver.service /etc/systemd/system/paperless-webserver.service
sudo systemctl daemon-reload
sudo systemctl enable --now paperless-webserver.service
</syntaxhighlight><syntaxhighlight lang="bash">
systemctl status paperless-webserver.service
</syntaxhighlight>Sollte in etwa so aussehen:<syntaxhighlight lang="bash">
● paperless-webserver.service - Paperless webserver
Loaded: loaded (/etc/systemd/system/paperless-webserver.service; enabled; preset: enabled)
Active: active (running) since Sat 2025-03-22 22:34:41 CET; 3s ago
Main PID: 7519 (granian asginl )
Tasks: 18 (limit: 9472)
Memory: 133.2M
CPU: 1.746s
CGroup: /system.slice/paperless-webserver.service
├─7519 "granian asginl :::8000 paperless.asgi:application"
└─7521 "granian asginl :::8000 paperless.asgi:application worker-1"

</syntaxhighlight>

=== Zusätzliche Pakete installieren ===
<syntaxhighlight lang="bash">
cd ..
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless python3 -m nltk.downloader stopwords
sudo -Hu paperless python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
'''Debian 12:'''
:<syntaxhighlight lang="bash">
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader stopwords
sudo -Hu paperless /opt/paperless/venv/bin/python3 -m nltk.downloader punkt_tab
</syntaxhighlight>
<syntaxhighlight lang="bash">
sudo apt install autotools-dev automake libtool libleptonica-dev
</syntaxhighlight><syntaxhighlight lang="bash">
cd ~
</syntaxhighlight>'''Debian 11:'''
:<syntaxhighlight lang="bash">
wget https://ftp.gnu.org/gnu/autoconf/autoconf-2.71.tar.xz
tar -xf autoconf-2.71.tar.xz
cd autoconf-2.71/
./configure
make -j$(nproc)
sudo make install
. ~/.profile
autoconf --version
</syntaxhighlight>
<syntaxhighlight lang="bash">
git clone https://github.com/agl/jbig2enc
cd jbig2enc
./autogen.sh
./configure && make -j$(nproc)
sudo make install
</syntaxhighlight>Für die Verarbeitung Dokumente in deutscher Sprache:<syntaxhighlight lang="bash">
sudo apt install tesseract-ocr-deu
</syntaxhighlight><syntaxhighlight lang="bash">
sudo -Hu paperless vi /opt/paperless/paperless.conf
</syntaxhighlight><syntaxhighlight lang="bash">
PAPERLESS_OCR_LANGUAGE=deu+eng
</syntaxhighlight>

=== ImageMagic konfigurieren: ===
<syntaxhighlight lang="bash">
sudo vi /etc/ImageMagick-6/policy.xml
</syntaxhighlight><syntaxhighlight lang="bash">
<policy domain="coder" rights="read|write" pattern="PDF" />
</syntaxhighlight>

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:32:17Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:28:13Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:19:45Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:18:52Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:18:33Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:17:54Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:17:20Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:16:49Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:15:06Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-22T21:06:37Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-21T20:09:24Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-21T20:08:37Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-21T20:05:36Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-21T20:04:38Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-21T19:57:40Z

Robin Tönniges:

Paperless-ngx "Bare Metal" installieren (Debian 11/12)

2025-03-21T19:55:15Z

Robin Tönniges: Die Seite wurde neu angelegt: „{{Infobox | Titel = Testumgebung | Bildname = | Bildbreite = | Bildtext = | Stil = 2 | Titelfarbe = 6 | Abschnittsfarbe = | Farbe = | Style = | Feldstyle = | Feldname1 = OS | Daten1 = Debian 11.11/12.10 | Feldname3 = paperless-ngx (Dev) | Daten3 = 2.15.0 }} Anleitung für die "Bare Metal" Installation von [https://docs.paperless-ngx.com/ paperless-ngx] mit dem Quellcode vom [https://github.c…“

Debian 11 auf Raspberry Pi 4 installieren

2025-01-11T05:28:24Z

Robin Tönniges:

Dies ist eine Anleitung um Debian 11 '''"Vanilla"''' auf dem Raspberry Pi zu installieren, welches nicht für den Raspberry Pi optimiert ist.

'''Achtung: Einige Raspberry Pi spezifische Funktionen, wie z.B. WLAN oder ein über I2C angesteuerter Lüfter (z.B. beim PoE HAT) funktionieren nicht.'''

Am sinnvollsten ist es direkt das aktuelle [https://downloads.raspberrypi.org/raspios_arm64/images/ Raspberry Pi OS 64 Bit Image] zu nutzen (<s>Basiert auf Debian 11 "Bullseye"</s>).

'''''Update: Die aktuellste Version von Raspberry OS 64 Bit basiert auf Debian 12 Bookworm!'''''

[[Datei:Rufus debian 11.png|mini]]

=== Image erstellen ===
'''[https://cdimage.debian.org/cdimage/release/current/arm64/iso-cd/ Aktuelles Debian Image herunterladen]'''

'''[https://github.com/pftf/RPi4/releases Raspberry Pi 4 UEFI Firmware Image herunterladen]'''

Um daraus ein Image für den Raspberry zu erzeugen brauchen wir die [https://rufus.ie/de/ Software Rufus]

* Zuerst die SD-Karte, den USB-Stick oder was auch immer mit dem PC verbinden.

''Sollte das externe Laufwerk nicht erkannt werden, muss unter '''Erweiterte Laufwerkseigenschaften''' der Haken bei '''USB-Festplatten anzeigen''' gesetzt werden.''

* Mit '''AUSWAHL''' das Debian 11 Image auswählen
* Danach mit '''STRG+AUSWAHL''' die '''RPi-UEFI-Firmware.zip''' auswählen (Mit STRG+AUSWAHL wird ein zweites Image hinzugefügt)
* Bei '''Partitionsschema''', '''GPT''' auswählen
* Danach auf '''START'''

Der Raspberry kann nun wie gewohnt mit dem Datenträger verbunden werden und sollte automatisch Booten.<br />

=== RAM Begrenzung deaktivieren ===
Das oben erstelle Image hat standardmäßig eine RAM-Begrenzung auf 3GB.

Falls der genutzte Raspberry Pi mehr RAM hat und man sinnvollerweise vorhat ihn komplett zu nutzen, kann dies wie folgt eingestellt werden...

Während der Raspberry hochfährt ESC drücken um ins UEFI BIOS zu kommen.

Im Menü dann ->

'''Device Manager''' -> '''Raspberry Pi Configuration''' -> '''Advanced Configuration''' -> '''Limit RAM to 3GB''' auf '''Disable'''

== Quellen ==
https://www.raspberrypi.org/forums/viewtopic.php?t=282839

== Kommentare ==
<comments nocache=true />
__KEIN_INHALTSVERZEICHNIS__

Debian 11 auf Raspberry Pi 4 installieren

2025-01-11T05:27:12Z

Robin Tönniges:

Dies ist eine Anleitung um Debian 11 '''"Vanilla"''' auf dem Raspberry Pi zu installieren, welches nicht für den Raspberry Pi optimiert ist.

'''Achtung: Einige Raspberry Pi spezifische Funktionen, wie z.B. WLAN oder ein über I2C angesteuerter Lüfter (z.B. beim PoE HAT) funktionieren nicht.'''

Am sinnvollsten ist es direkt das aktuelle [https://downloads.raspberrypi.org/raspios_arm64/images/ Raspberry Pi OS 64 Bit Image] zu nutzen (Basiert auf Debian 11 "Bullseye").

'''''Update: Die aktuellste Version von Raspberry OS 64 Bit basiert auf Debian 12 Bookworm!'''''

[[Datei:Rufus debian 11.png|mini]]

=== Image erstellen ===
'''[https://cdimage.debian.org/cdimage/release/current/arm64/iso-cd/ Aktuelles Debian Image herunterladen]'''

'''[https://github.com/pftf/RPi4/releases Raspberry Pi 4 UEFI Firmware Image herunterladen]'''

Um daraus ein Image für den Raspberry zu erzeugen brauchen wir die [https://rufus.ie/de/ Software Rufus]

* Zuerst die SD-Karte, den USB-Stick oder was auch immer mit dem PC verbinden.

''Sollte das externe Laufwerk nicht erkannt werden, muss unter '''Erweiterte Laufwerkseigenschaften''' der Haken bei '''USB-Festplatten anzeigen''' gesetzt werden.''

* Mit '''AUSWAHL''' das Debian 11 Image auswählen
* Danach mit '''STRG+AUSWAHL''' die '''RPi-UEFI-Firmware.zip''' auswählen (Mit STRG+AUSWAHL wird ein zweites Image hinzugefügt)
* Bei '''Partitionsschema''', '''GPT''' auswählen
* Danach auf '''START'''

Der Raspberry kann nun wie gewohnt mit dem Datenträger verbunden werden und sollte automatisch Booten.<br />

=== RAM Begrenzung deaktivieren ===
Das oben erstelle Image hat standardmäßig eine RAM-Begrenzung auf 3GB.

Falls der genutzte Raspberry Pi mehr RAM hat und man sinnvollerweise vorhat ihn komplett zu nutzen, kann dies wie folgt eingestellt werden...

Während der Raspberry hochfährt ESC drücken um ins UEFI BIOS zu kommen.

Im Menü dann ->

'''Device Manager''' -> '''Raspberry Pi Configuration''' -> '''Advanced Configuration''' -> '''Limit RAM to 3GB''' auf '''Disable'''

== Quellen ==
https://www.raspberrypi.org/forums/viewtopic.php?t=282839

== Kommentare ==
<comments nocache=true />
__KEIN_INHALTSVERZEICHNIS__

Kubernetes Dashboard mit Keycloak OIDC

2025-01-11T05:22:29Z

Robin Tönniges:

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = AlmaLinux 8.7
| Feldname2 = Keycloak | Daten2 = 20.0.2
| Feldname3 = Kubernetes | Daten3 = 1.26.0
| Feldname4 = Kubenetes-Dashboard | Daten4 = 2.7.0
| Feldname5 = MetalLB | Daten5 = 0.13.7
| Feldname6 = Ingress-Nginx | Daten6 = 1.5.1
| Feldname7 = OAUTH2-Proxy | Daten7 = 7.4.0
}}

=== API-Server konfigurieren ===
<syntaxhighlight lang="bash">
vi /etc/kubernetes/manifests/kube-apiserver.yaml
</syntaxhighlight><syntaxhighlight lang="yaml" line="1">
spec:
containers:
- command:
- kube-apiserver
...
- --oidc-issuer-url=https://<my.keycloak.server>/realms/<Realm-Name>
- --oidc-client-id=k8s-cluster
- --oidc-username-claim=email
#- --oidc-ca-file=/path/to/oidc-ca.pem
#- --oidc-username-prefix=-
</syntaxhighlight>

'''Hinweis:'''

''Wenn <code>oidc-username-claim</code> '''NICHT''' 'email' ist, wird standardmäßig die 'issuer-url' als Präfix vor den Benutzer gestellt (z.B. https://<my.keycloak.server>/realms/<Realm-Name>:<username>).''

''Um den Präfix zu deaktivieren muss bei <code>oidc-username-prefix</code> der Wert '-' angegeben werden.''

=== Load Balancer installieren ===
'# MetalLB installieren / Aktiviert den Service Typ "LoadBalancer" der sonst nur in Cloud Umgebungen verfügbar ist

'# Bildet IPs aus dem Cluster in einen physischen Adressbereich des LANs

==== Ports in der Firewall öffnen ====
Sowohl auf dem Controller als auch den Worker-Nodes<syntaxhighlight lang="bash">
firewall-cmd --permanent --add-port=7472/tcp
firewall-cmd --permanent --add-port=7946/tcp
firewall-cmd --permanent --add-port=7946/udp
firewall-cmd --reload
</syntaxhighlight>

==== Installieren ====
<syntaxhighlight lang="bash">
kubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.13.7/config/manifests/metallb-native.yaml
</syntaxhighlight>
address_pool.yaml
<syntaxhighlight lang="yaml" line="1">
apiVersion: metallb.io/v1beta1
kind: IPAddressPool
metadata:
name: first-pool
namespace: metallb-system
spec:
addresses:
- 192.168.1.240-192.168.1.250
</syntaxhighlight>

l2_advert.yaml
<syntaxhighlight lang="yaml" line="1">
apiVersion: metallb.io/v1beta1
kind: L2Advertisement
metadata:
name: example
namespace: metallb-system
#- first-pool
</syntaxhighlight>
IPAddressPools können explizit ausgewählt werden. Ohne Angabe werden alle Pools dem L2Advertisement zugeordnet.

<syntaxhighlight lang="bash">
kubectl apply -f address_pool.yaml
kubectl apply -f l2_advert.yaml
</syntaxhighlight>

=== Reverse Proxy installieren (ingress-nginx) ===
Reverse Proxy um mehrere Domains auf einer IP erreichbar zu machen.

values.yaml
<syntaxhighlight lang="yaml" line="1">
controller:
config:
proxy-buffer-size: "8k"

#extraArgs:
#default-ssl-certificate: "default/my-tls-secret"
</syntaxhighlight>'''Hinweise:'''

''Bei Keycloak kann es vorkommen, dass mehr als 4 kb Daten über den Header gesendet werden.''

''Wenn der Header zu groß wird, bekommt man einen Fehler (502).''

''Deswegen erhöhen wir diesen direkt während der Installation auf 8 kb.''

''Für TLS benötigen wir ein 'Secret" mit dem "Privat Key" und dem "Public Certificate" für die Domain, die später für das Dashboard genutzt werden soll.''

''Dieses kann man als Standard, direkt in der Config für Ingress-Nginx hinerlegen oder später im Ingress definieren.''

'''Tipp:'''

Wenn man bei <code>default-ssl-certificate</code> ein Wildcard-Zertifikat (z.B. *.my-cluster.host) für den Cluster hinterlegt,

kann für jeden Ingress einfach eine Sub-Domain vergeben, die dann automatisch ein gültiges Zertifikat hat.

Installation starten:
<syntaxhighlight lang="bash">
helm upgrade --install ingress-nginx ingress-nginx \
--repo https://kubernetes.github.io/ingress-nginx \
--namespace ingress-nginx --create-namespace \
-f values.yaml
</syntaxhighlight>

=== OAUTH2 Proxy installieren ===
Authentifizierung gegen Keyclok und Token Weiterleitung an Dashboard

values.yaml
<syntaxhighlight lang="yaml" line="1">
extraArgs:
provider: keycloak-oidc
#provider-display-name: OIDC Login
#http-address: "0.0.0.0:4180"
#skip-provider-button: true
#skip-jwt-bearer-tokens: true
#ssl-insecure-skip-verify: true
#ssl-upstream-insecure-skip-verify: true
#pass-access-token: true
#pass-authorization-header: true
set-authorization-header: true
#set-xauthrequest: true
client-id: XXX # Change XXX to your client_id
client-secret: XXX # Change XXX to your client_secret
cookie-secret: XXX # Generate with 'openssl rand -base64 32 | head -c 32 | base64'
#cookie-secure: false
#cookie-httponly: false
cookie-refresh: 4m # Zeit nach der ein neuer Access Token über den Refresh Token bezogen wird
oidc-issuer-url: "https://<my.keycloak.server>/realms/<Realm-Name>"
redirect-url: "https://<my.dashboard.url>/oauth2/callback"
#whitelist-domain: ["*"]
#allowed-group: ["*"]
#allowed-role: ["*"]
#email-domain: ["*"]
</syntaxhighlight>
'''Hinweis:'''

''Der Parameter <code>cookie-refresh</code> sollte kleiner als die "Access Token Lifespan" in Keycloak sein ("Realm Settings->Token").''

Installation starten:

<syntaxhighlight lang="bash">
helm upgrade --install oauth2-proxy oauth2-proxy \
--repo https://oauth2-proxy.github.io/manifests \
--namespace kubernetes-dashboard \
-f values.yaml
</syntaxhighlight>

===Dem Keycloak Benutzer die Admin Rolle zuweisen===
oidc-role.yaml
<syntaxhighlight lang="yaml">
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: oidc-user
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: ClusterRole
name: cluster-admin
subjects:
- kind: User
name: user@keycloak.com
namespace: kube-system
</syntaxhighlight>'''''Hinweis:'''''

''Der Benutzername (subjects.name) entspricht dem'' <code>oidc-username-claim</code> ''aus der "kube-apiserver.yaml".''
<syntaxhighlight lang="bash">
kubectl apply -f oidc-role.yaml
</syntaxhighlight>

===Ingress erstellen===
<syntaxhighlight lang="yaml" line="1">
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
nginx.ingress.kubernetes.io/auth-url: "https://$host/oauth2/auth"
nginx.ingress.kubernetes.io/auth-signin: "https://$host/oauth2/start?rd=$escaped_request_uri"
nginx.ingress.kubernetes.io/auth-response-headers: "authorization"
name: k8s-dashboard
namespace: kubernetes-dashboard
spec:
ingressClassName: nginx
tls:
- hosts:
- my.dashboard.url
rules:
- host: my.dashboard.url
http:
paths:
- backend:
service:
name: kubernetes-dashboard
port:
number: 443
path: /
pathType: Prefix
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: k8s-dashboard-oauth
namespace: oauth2-proxy
spec:
ingressClassName: nginx
tls:
- hosts:
- my.dashboard.url
rules:
- host: my.dashboard.url
http:
paths:
- backend:
service:
name: oauth2-proxy
port:
number: 80
path: /oauth2
pathType: Prefix
</syntaxhighlight><syntaxhighlight lang="bash">
kubectl apply -f ingress.yaml
</syntaxhighlight>

Kubernetes Dashboard mit Keycloak OIDC

2025-01-11T05:21:54Z

Robin Tönniges:

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = AlmaLinux 8.7
| Feldname2 = Keycloak | Daten2 = 20.0.2
| Feldname3 = Kubernetes | Daten3 = 1.26.0
| Feldname4 = Kubenetes-Dashboard | Daten6 = 2.7.0
| Feldname5 = MetalLB | Daten4 = 0.13.7
| Feldname6 = Ingress-Nginx | Daten5 = 1.5.1
| Feldname7 = OAUTH2-Proxy | Daten6 = 7.4.0
}}

=== API-Server konfigurieren ===
<syntaxhighlight lang="bash">
vi /etc/kubernetes/manifests/kube-apiserver.yaml
</syntaxhighlight><syntaxhighlight lang="yaml" line="1">
spec:
containers:
- command:
- kube-apiserver
...
- --oidc-issuer-url=https://<my.keycloak.server>/realms/<Realm-Name>
- --oidc-client-id=k8s-cluster
- --oidc-username-claim=email
#- --oidc-ca-file=/path/to/oidc-ca.pem
#- --oidc-username-prefix=-
</syntaxhighlight>

'''Hinweis:'''

''Wenn <code>oidc-username-claim</code> '''NICHT''' 'email' ist, wird standardmäßig die 'issuer-url' als Präfix vor den Benutzer gestellt (z.B. https://<my.keycloak.server>/realms/<Realm-Name>:<username>).''

''Um den Präfix zu deaktivieren muss bei <code>oidc-username-prefix</code> der Wert '-' angegeben werden.''

=== Load Balancer installieren ===
'# MetalLB installieren / Aktiviert den Service Typ "LoadBalancer" der sonst nur in Cloud Umgebungen verfügbar ist

'# Bildet IPs aus dem Cluster in einen physischen Adressbereich des LANs

==== Ports in der Firewall öffnen ====
Sowohl auf dem Controller als auch den Worker-Nodes<syntaxhighlight lang="bash">
firewall-cmd --permanent --add-port=7472/tcp
firewall-cmd --permanent --add-port=7946/tcp
firewall-cmd --permanent --add-port=7946/udp
firewall-cmd --reload
</syntaxhighlight>

==== Installieren ====
<syntaxhighlight lang="bash">
kubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.13.7/config/manifests/metallb-native.yaml
</syntaxhighlight>
address_pool.yaml
<syntaxhighlight lang="yaml" line="1">
apiVersion: metallb.io/v1beta1
kind: IPAddressPool
metadata:
name: first-pool
namespace: metallb-system
spec:
addresses:
- 192.168.1.240-192.168.1.250
</syntaxhighlight>

l2_advert.yaml
<syntaxhighlight lang="yaml" line="1">
apiVersion: metallb.io/v1beta1
kind: L2Advertisement
metadata:
name: example
namespace: metallb-system
#- first-pool
</syntaxhighlight>
IPAddressPools können explizit ausgewählt werden. Ohne Angabe werden alle Pools dem L2Advertisement zugeordnet.

<syntaxhighlight lang="bash">
kubectl apply -f address_pool.yaml
kubectl apply -f l2_advert.yaml
</syntaxhighlight>

=== Reverse Proxy installieren (ingress-nginx) ===
Reverse Proxy um mehrere Domains auf einer IP erreichbar zu machen.

values.yaml
<syntaxhighlight lang="yaml" line="1">
controller:
config:
proxy-buffer-size: "8k"

#extraArgs:
#default-ssl-certificate: "default/my-tls-secret"
</syntaxhighlight>'''Hinweise:'''

''Bei Keycloak kann es vorkommen, dass mehr als 4 kb Daten über den Header gesendet werden.''

''Wenn der Header zu groß wird, bekommt man einen Fehler (502).''

''Deswegen erhöhen wir diesen direkt während der Installation auf 8 kb.''

''Für TLS benötigen wir ein 'Secret" mit dem "Privat Key" und dem "Public Certificate" für die Domain, die später für das Dashboard genutzt werden soll.''

''Dieses kann man als Standard, direkt in der Config für Ingress-Nginx hinerlegen oder später im Ingress definieren.''

'''Tipp:'''

Wenn man bei <code>default-ssl-certificate</code> ein Wildcard-Zertifikat (z.B. *.my-cluster.host) für den Cluster hinterlegt,

kann für jeden Ingress einfach eine Sub-Domain vergeben, die dann automatisch ein gültiges Zertifikat hat.

Installation starten:
<syntaxhighlight lang="bash">
helm upgrade --install ingress-nginx ingress-nginx \
--repo https://kubernetes.github.io/ingress-nginx \
--namespace ingress-nginx --create-namespace \
-f values.yaml
</syntaxhighlight>

=== OAUTH2 Proxy installieren ===
Authentifizierung gegen Keyclok und Token Weiterleitung an Dashboard

values.yaml
<syntaxhighlight lang="yaml" line="1">
extraArgs:
provider: keycloak-oidc
#provider-display-name: OIDC Login
#http-address: "0.0.0.0:4180"
#skip-provider-button: true
#skip-jwt-bearer-tokens: true
#ssl-insecure-skip-verify: true
#ssl-upstream-insecure-skip-verify: true
#pass-access-token: true
#pass-authorization-header: true
set-authorization-header: true
#set-xauthrequest: true
client-id: XXX # Change XXX to your client_id
client-secret: XXX # Change XXX to your client_secret
cookie-secret: XXX # Generate with 'openssl rand -base64 32 | head -c 32 | base64'
#cookie-secure: false
#cookie-httponly: false
cookie-refresh: 4m # Zeit nach der ein neuer Access Token über den Refresh Token bezogen wird
oidc-issuer-url: "https://<my.keycloak.server>/realms/<Realm-Name>"
redirect-url: "https://<my.dashboard.url>/oauth2/callback"
#whitelist-domain: ["*"]
#allowed-group: ["*"]
#allowed-role: ["*"]
#email-domain: ["*"]
</syntaxhighlight>
'''Hinweis:'''

''Der Parameter <code>cookie-refresh</code> sollte kleiner als die "Access Token Lifespan" in Keycloak sein ("Realm Settings->Token").''

Installation starten:

<syntaxhighlight lang="bash">
helm upgrade --install oauth2-proxy oauth2-proxy \
--repo https://oauth2-proxy.github.io/manifests \
--namespace kubernetes-dashboard \
-f values.yaml
</syntaxhighlight>

===Dem Keycloak Benutzer die Admin Rolle zuweisen===
oidc-role.yaml
<syntaxhighlight lang="yaml">
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: oidc-user
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: ClusterRole
name: cluster-admin
subjects:
- kind: User
name: user@keycloak.com
namespace: kube-system
</syntaxhighlight>'''''Hinweis:'''''

''Der Benutzername (subjects.name) entspricht dem'' <code>oidc-username-claim</code> ''aus der "kube-apiserver.yaml".''
<syntaxhighlight lang="bash">
kubectl apply -f oidc-role.yaml
</syntaxhighlight>

===Ingress erstellen===
<syntaxhighlight lang="yaml" line="1">
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
nginx.ingress.kubernetes.io/auth-url: "https://$host/oauth2/auth"
nginx.ingress.kubernetes.io/auth-signin: "https://$host/oauth2/start?rd=$escaped_request_uri"
nginx.ingress.kubernetes.io/auth-response-headers: "authorization"
name: k8s-dashboard
namespace: kubernetes-dashboard
spec:
ingressClassName: nginx
tls:
- hosts:
- my.dashboard.url
rules:
- host: my.dashboard.url
http:
paths:
- backend:
service:
name: kubernetes-dashboard
port:
number: 443
path: /
pathType: Prefix
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: k8s-dashboard-oauth
namespace: oauth2-proxy
spec:
ingressClassName: nginx
tls:
- hosts:
- my.dashboard.url
rules:
- host: my.dashboard.url
http:
paths:
- backend:
service:
name: oauth2-proxy
port:
number: 80
path: /oauth2
pathType: Prefix
</syntaxhighlight><syntaxhighlight lang="bash">
kubectl apply -f ingress.yaml
</syntaxhighlight>

Kubernetes Dashboard mit Keycloak OIDC

2025-01-11T05:21:40Z

Robin Tönniges:

{{Infobox
| Titel = Testumgebung
| Bildname =
| Bildbreite =
| Bildtext =
| Stil = 2
| Titelfarbe = 6
| Abschnittsfarbe =
| Farbe =
| Style =
| Feldstyle =
| Feldname1 = OS | Daten1 = AlmaLinux 8.7
| Feldname2 = Keycloak | Daten2 = 20.0.2
| Feldname3 = Kubernetes | Daten3 = 1.26.0
| Feldname6 = Kubenetes-Dashboard | Daten6 = 2.7.0
| Feldname4 = MetalLB | Daten4 = 0.13.7
| Feldname5 = Ingress-Nginx | Daten5 = 1.5.1
| Feldname6 = OAUTH2-Proxy | Daten6 = 7.4.0
}}

=== API-Server konfigurieren ===
<syntaxhighlight lang="bash">
vi /etc/kubernetes/manifests/kube-apiserver.yaml
</syntaxhighlight><syntaxhighlight lang="yaml" line="1">
spec:
containers:
- command:
- kube-apiserver
...
- --oidc-issuer-url=https://<my.keycloak.server>/realms/<Realm-Name>
- --oidc-client-id=k8s-cluster
- --oidc-username-claim=email
#- --oidc-ca-file=/path/to/oidc-ca.pem
#- --oidc-username-prefix=-
</syntaxhighlight>

'''Hinweis:'''

''Wenn <code>oidc-username-claim</code> '''NICHT''' 'email' ist, wird standardmäßig die 'issuer-url' als Präfix vor den Benutzer gestellt (z.B. https://<my.keycloak.server>/realms/<Realm-Name>:<username>).''

''Um den Präfix zu deaktivieren muss bei <code>oidc-username-prefix</code> der Wert '-' angegeben werden.''

=== Load Balancer installieren ===
'# MetalLB installieren / Aktiviert den Service Typ "LoadBalancer" der sonst nur in Cloud Umgebungen verfügbar ist

'# Bildet IPs aus dem Cluster in einen physischen Adressbereich des LANs

==== Ports in der Firewall öffnen ====
Sowohl auf dem Controller als auch den Worker-Nodes<syntaxhighlight lang="bash">
firewall-cmd --permanent --add-port=7472/tcp
firewall-cmd --permanent --add-port=7946/tcp
firewall-cmd --permanent --add-port=7946/udp
firewall-cmd --reload
</syntaxhighlight>

==== Installieren ====
<syntaxhighlight lang="bash">
kubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.13.7/config/manifests/metallb-native.yaml
</syntaxhighlight>
address_pool.yaml
<syntaxhighlight lang="yaml" line="1">
apiVersion: metallb.io/v1beta1
kind: IPAddressPool
metadata:
name: first-pool
namespace: metallb-system
spec:
addresses:
- 192.168.1.240-192.168.1.250
</syntaxhighlight>

l2_advert.yaml
<syntaxhighlight lang="yaml" line="1">
apiVersion: metallb.io/v1beta1
kind: L2Advertisement
metadata:
name: example
namespace: metallb-system
#- first-pool
</syntaxhighlight>
IPAddressPools können explizit ausgewählt werden. Ohne Angabe werden alle Pools dem L2Advertisement zugeordnet.

<syntaxhighlight lang="bash">
kubectl apply -f address_pool.yaml
kubectl apply -f l2_advert.yaml
</syntaxhighlight>

=== Reverse Proxy installieren (ingress-nginx) ===
Reverse Proxy um mehrere Domains auf einer IP erreichbar zu machen.

values.yaml
<syntaxhighlight lang="yaml" line="1">
controller:
config:
proxy-buffer-size: "8k"

#extraArgs:
#default-ssl-certificate: "default/my-tls-secret"
</syntaxhighlight>'''Hinweise:'''

''Bei Keycloak kann es vorkommen, dass mehr als 4 kb Daten über den Header gesendet werden.''

''Wenn der Header zu groß wird, bekommt man einen Fehler (502).''

''Deswegen erhöhen wir diesen direkt während der Installation auf 8 kb.''

''Für TLS benötigen wir ein 'Secret" mit dem "Privat Key" und dem "Public Certificate" für die Domain, die später für das Dashboard genutzt werden soll.''

''Dieses kann man als Standard, direkt in der Config für Ingress-Nginx hinerlegen oder später im Ingress definieren.''

'''Tipp:'''

Wenn man bei <code>default-ssl-certificate</code> ein Wildcard-Zertifikat (z.B. *.my-cluster.host) für den Cluster hinterlegt,

kann für jeden Ingress einfach eine Sub-Domain vergeben, die dann automatisch ein gültiges Zertifikat hat.

Installation starten:
<syntaxhighlight lang="bash">
helm upgrade --install ingress-nginx ingress-nginx \
--repo https://kubernetes.github.io/ingress-nginx \
--namespace ingress-nginx --create-namespace \
-f values.yaml
</syntaxhighlight>

=== OAUTH2 Proxy installieren ===
Authentifizierung gegen Keyclok und Token Weiterleitung an Dashboard

values.yaml
<syntaxhighlight lang="yaml" line="1">
extraArgs:
provider: keycloak-oidc
#provider-display-name: OIDC Login
#http-address: "0.0.0.0:4180"
#skip-provider-button: true
#skip-jwt-bearer-tokens: true
#ssl-insecure-skip-verify: true
#ssl-upstream-insecure-skip-verify: true
#pass-access-token: true
#pass-authorization-header: true
set-authorization-header: true
#set-xauthrequest: true
client-id: XXX # Change XXX to your client_id
client-secret: XXX # Change XXX to your client_secret
cookie-secret: XXX # Generate with 'openssl rand -base64 32 | head -c 32 | base64'
#cookie-secure: false
#cookie-httponly: false
cookie-refresh: 4m # Zeit nach der ein neuer Access Token über den Refresh Token bezogen wird
oidc-issuer-url: "https://<my.keycloak.server>/realms/<Realm-Name>"
redirect-url: "https://<my.dashboard.url>/oauth2/callback"
#whitelist-domain: ["*"]
#allowed-group: ["*"]
#allowed-role: ["*"]
#email-domain: ["*"]
</syntaxhighlight>
'''Hinweis:'''

''Der Parameter <code>cookie-refresh</code> sollte kleiner als die "Access Token Lifespan" in Keycloak sein ("Realm Settings->Token").''

Installation starten:

<syntaxhighlight lang="bash">
helm upgrade --install oauth2-proxy oauth2-proxy \
--repo https://oauth2-proxy.github.io/manifests \
--namespace kubernetes-dashboard \
-f values.yaml
</syntaxhighlight>

===Dem Keycloak Benutzer die Admin Rolle zuweisen===
oidc-role.yaml
<syntaxhighlight lang="yaml">
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
name: oidc-user
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: ClusterRole
name: cluster-admin
subjects:
- kind: User
name: user@keycloak.com
namespace: kube-system
</syntaxhighlight>'''''Hinweis:'''''

''Der Benutzername (subjects.name) entspricht dem'' <code>oidc-username-claim</code> ''aus der "kube-apiserver.yaml".''
<syntaxhighlight lang="bash">
kubectl apply -f oidc-role.yaml
</syntaxhighlight>

===Ingress erstellen===
<syntaxhighlight lang="yaml" line="1">
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"
nginx.ingress.kubernetes.io/auth-url: "https://$host/oauth2/auth"
nginx.ingress.kubernetes.io/auth-signin: "https://$host/oauth2/start?rd=$escaped_request_uri"
nginx.ingress.kubernetes.io/auth-response-headers: "authorization"
name: k8s-dashboard
namespace: kubernetes-dashboard
spec:
ingressClassName: nginx
tls:
- hosts:
- my.dashboard.url
rules:
- host: my.dashboard.url
http:
paths:
- backend:
service:
name: kubernetes-dashboard
port:
number: 443
path: /
pathType: Prefix
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: k8s-dashboard-oauth
namespace: oauth2-proxy
spec:
ingressClassName: nginx
tls:
- hosts:
- my.dashboard.url
rules:
- host: my.dashboard.url
http:
paths:
- backend:
service:
name: oauth2-proxy
port:
number: 80
path: /oauth2
pathType: Prefix
</syntaxhighlight><syntaxhighlight lang="bash">
kubectl apply -f ingress.yaml
</syntaxhighlight>

Raspberry Pi Kernel für Proxmox optimieren

2024-05-28T18:04:26Z

Robin Tönniges:

Um auf einem [[Proxmox auf Raspberry Pi (Pimox)|Raspberry Proxmox Cluster]], Container in einem RBD Storage zu speichern oder auf einer Linux Bridge [https://pve.proxmox.com/wiki/Network_Configuration#_vlan_802_1q VLAN awareness] zu aktivieren, muss der Raspberry Kernel leicht modifiziert werden.

Diese Anleitung zeigt wie man den Raspberry Pi Kernel optimiert für Proxmox baut.

== Vorbereitungen ==
'''Getestet auf Ubuntu 20.04.2 (64 Bit)'''

Abhängigkeiten und 64Bit Toolchain installieren:<syntaxhighlight lang="bash">
apt install git bc bison flex libssl-dev make libc6-dev libncurses5-dev crossbuild-essential-arm64
</syntaxhighlight>Ins <code>/home/<user>/</code> Verzeichnis wechseln und Git-Repo klonen:<syntaxhighlight lang="bash">
git clone --depth=1 https://github.com/raspberrypi/linux
</syntaxhighlight>Konfiguration für den Raspberry Pi 4 64 Bit erstellen:<syntaxhighlight lang="bash" line="1">
cd linux
KERNEL=kernel8
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- bcm2711_defconfig
</syntaxhighlight>Die erstellte .config Datei mit dem Editor öffnen:<syntaxhighlight lang="bash">
vi .config
</syntaxhighlight>

== Module aktivieren ==

=== RBD-Modul (Container auf RBD-Storage speichern) ===

Den Eintrag für das RBD-Modul finden:<syntaxhighlight lang="bash">
# CONFIG_BLK_DEV_RBD is not set
</syntaxhighlight>Kommentar entfernen und als Modul einbinden:<syntaxhighlight lang="bash">
CONFIG_BLK_DEV_RBD=m
</syntaxhighlight>

=== VLAN-Filtering aktivieren (Linux Bridge mit VLAN awareness) ===

Den Eintrag für das VLAN-Filtering finden:<syntaxhighlight lang="bash">
# CONFIG_BRIDGE_VLAN_FILTERING is not set
</syntaxhighlight>Die Funktion aktivieren:<syntaxhighlight lang="bash">
CONFIG_BRIDGE_VLAN_FILTERING=y
</syntaxhighlight>

=== KSM-Sharing aktivieren (RAM bei mehreren VMs sparen) ===
KSM (Kernel Samepage Merging) führt identische Teile des RAMs von mehreren VMs zusammen.

Bei Proxmox tritt dieser Effekt erst ein wenn der Host >=80% RAM-Auslastung hat.<ref>https://pve.proxmox.com/wiki/Dynamic_Memory_Management#KSM_in_action</ref>

Den Eintrag für das KSM-Sharing finden:<syntaxhighlight lang="bash">
# CONFIG_KSM is not set
</syntaxhighlight>Die Funktion aktivieren:<syntaxhighlight lang="bash">
CONFIG_KSM=y
</syntaxhighlight>
[[Datei:Proxmox Node KSM Sharing.png|mini|KSM sharing / Proxmox Node mit drei VMs]]
Zur Funktionskontrolle kann in der Übersicht eines Proxmox Nodes der Wert "KSM sharing" beobachtet werden.

Alternativ kann folgender Befehl in der Shell ausgeführt werden:<syntaxhighlight lang="bash">
watch cat /sys/kernel/mm/ksm/pages_sharing
</syntaxhighlight>

== Kernel bauen ==
Mit folgendem Befehl den Build-Prozess starten:<syntaxhighlight lang="bash">
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- Image modules dtbs
</syntaxhighlight>''Tipp: Mit dem Parameter'' <code>-j$(nproc)</code> ''führt der make-Befehl mehrere Jobs parallel aus (Soviele wie die CPU Kerne hat).''

Alle Abfragen mit '''ENTER''' bestätigen

Lange warten...

Als nächstes muss die SD Karte des Raspberry eingebunden werden.

Bei Ubuntu 20.04 mit Desktop geschieht dies automatisch sobald Ihr die SD Karte einlegt.

Ansonsten müsst ihr sie manuell einbinden:<syntaxhighlight lang="bash" line="1">
cd /mnt
mkdir mnt/fat32
mkdir mnt/ext4
sudo mount /dev/sdb6 mnt/fat32
sudo mount /dev/sdb7 mnt/ext4
</syntaxhighlight>
''Der Pfad zu den Partitionen (sdb6, sdb7) muss ggf. angepasst werden.''

''Bei der automatischen Einbindung unter Ubuntu heißen die Verzeichnisse eventuell anders:''

- <code>/mnt/fat32</code> → <code>/media/<user>/boot</code>

- <code>/mnt/ext4</code> → <code>/media/<user>/rootfs</code>

=== Kernel Module auf SD Karte installieren ===

Bei manueller Einbindung:<syntaxhighlight lang="bash">
sudo env PATH=$PATH make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- INSTALL_MOD_PATH=/mnt/ext4 modules_install
</syntaxhighlight>
Bei automatischer Einbindung:<syntaxhighlight lang="bash">
sudo env PATH=$PATH make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- INSTALL_MOD_PATH=/media/<user>/rootfs modules_install
</syntaxhighlight>

=== Kernel auf SD Karte kopieren ===
Bei manueller Einbindung:<syntaxhighlight lang="bash" line="1">
sudo cp /mnt/fat32/$KERNEL.img /mnt/fat32/$KERNEL-backup.img
sudo cp arch/arm64/boot/Image /mnt/fat32/$KERNEL.img
sudo cp arch/arm64/boot/dts/broadcom/*.dtb /mnt/fat32/
sudo cp arch/arm64/boot/dts/overlays/*.dtb* /mnt/fat32/overlays/
sudo cp arch/arm64/boot/dts/overlays/README /mnt/fat32/overlays/
sudo umount mnt/fat32
sudo umount mnt/ext4
</syntaxhighlight>Bei automatischer Einbindung:<syntaxhighlight lang="bash" line="1">
sudo cp /media/<user>/boot/$KERNEL.img /media/<user>/boot/$KERNEL-backup.img
sudo cp arch/arm64/boot/Image /media/<user>/boot/$KERNEL.img
sudo cp arch/arm64/boot/dts/broadcom/*.dtb /media/<user>/boot/
sudo cp arch/arm64/boot/dts/overlays/*.dtb* /media/<user>/boot/overlays/
sudo cp arch/arm64/boot/dts/overlays/README /media/<user>/boot/overlays/
sudo umount /media/<user>/boot
sudo umount /media/<user>/rootfs
</syntaxhighlight>

=== Kernel Update blockieren ===
Damit beim nächsten <code>apt update/upgrade</code> der Kernel nicht durch die offizielle Version ersetzt wird, blockieren wir die Updates:<syntaxhighlight lang="bash">
sudo apt-mark hold raspberrypi-bootloader raspberrypi-kernel raspberrypi-kernel-headers
</syntaxhighlight>

== Quellen ==
https://www.raspberrypi.org/documentation/linux/kernel/building.md

=== Einzelnachweise ===
<references />

== Kommentare ==
<comments nocache=true />

[[Kategorie:Raspberry Pi]]