{"id":1623,"date":"2023-11-12T16:30:34","date_gmt":"2023-11-12T15:30:34","guid":{"rendered":"https:\/\/digital-cleaning.de\/?p=1623"},"modified":"2025-10-31T17:23:51","modified_gmt":"2025-10-31T16:23:51","slug":"paperless-ngx-teil-5-installation-auf-dem-raspberry-pi-ganz-einfach","status":"publish","type":"post","link":"https:\/\/digital-cleaning.de\/index.php\/paperless-ngx-teil-5-installation-auf-dem-raspberry-pi-ganz-einfach\/","title":{"rendered":"Paperless-ngx, Teil 5: Installation auf dem Raspberry Pi. Ganz einfach."},"content":{"rendered":"
\n
\"\"<\/figure><\/div>\n\n\n

Wer sich auf YouTube Anleitungen f\u00fcr die Installation von Paperless-ngx anschaut, wird rasch das Gef\u00fchl erhalten, dass es sich um eine Sache f\u00fcr IT-Nerds handelt. In Wahrheit gen\u00fcgen zwei einfache Befehle – und schon funktioniert Paperless-ngx auf dem Raspberry Pi. Das schafft jeder – selbst wenn er bisher noch nie etwas mit der kleinen Box zu tun hatte.<\/p>\n\n\n\n

Auf welchen Raspberry-Pi-Modellen l\u00e4uft Paperless-ngx? <\/h2>\n\n\n\n

Paperless-ngx ist gen\u00fcgsam. Ich selbst habe bisher einen Raspberry Pi 4 mit 4 GB bzw. den Tastatur-RPi 400 eingesetzt – auch mit rund 1.000 Dokumenten lief Paperless absolut rund zu z\u00fcgig. (Die 64-bit-Variante des Betriebssystems muss installiert sein.) Seit einigen Tagen verwende ich den neuen Raspberry Pi 5 mit 8 GB. Der nimmt umfangreiche PDF-Dateien durch seine hohe Leistung zwar deutlich rascher in die Datenbank auf, bei Suche und Abruf gibt es hingegen keinen sp\u00fcrbaren Unterschied.<\/p>\n\n\n

\n
\"\"<\/a>
Drei Dinge braucht der Installateur …<\/figcaption><\/figure><\/div>\n\n\n

Tipp f\u00fcr Neu-Anschaffung<\/h3>\n\n\n\n

Falls man noch gar keinen Raspberry Pi besitzt, so k\u00f6nnte das 400-er-Modell eine gute Wahl sein, das man aktuell z.B. bei Berrybase f\u00fcr 79 Euro erh\u00e4lt (ist auch lieferbar). Der 400-er hat eine h\u00f6here Taktung als der 4-er und verf\u00fcgt ebenfalls \u00fcber 4 GB. Ferner spart man sich das Geh\u00e4use und den L\u00fcfter – beim 400-er reicht die passive K\u00fchlung vollkommen. Die Tastatur ist ja auch dabei, so dass man quasi einen Zweit-PC f\u00fcr Homeoffice, Homeschooling oder das G\u00e4stezimmer hat.<\/p>\n\n\n\n

Ansonsten fallen ja gerade die Preise durch das Erscheinen des 5-er-Modells, so dass man bei eBay oder Kleinanzeigenm\u00e4rkten f\u00fcndig werden kann.<\/p>\n\n\n\n

Welches (64-Bit-)Betriebssystem sollte man einsetzen?<\/h3>\n\n\n\n

Man kann auf dem Raspberry Pi unterschiedliche Linux-Systeme verwenden. Aber Raspberry Pi OS<\/a> ist auf jeden Fall eine gute Wahl. Der 5-er l\u00e4uft nur noch mit der neuesten Version („Bookworm“), auf dem 4-er k\u00f6nnte man es auch bei der bisherigen Version („Bullseye“) belassen. Die Desktop-Oberfl\u00e4che ben\u00f6tigt man nicht unbedingt, sie hat aber einige Vorteile, wie wir beim sp\u00e4teren Backup-Kapitel noch sehen werden. Achtung: 32-Bit-Systeme werden von Paperless-ngx nicht mehr unterst\u00fctzt!<\/strong><\/p>\n\n\n\n

Welche Speichergr\u00f6\u00dfe ben\u00f6tigt man?<\/h3>\n\n\n\n

Fr\u00fcher ben\u00f6tigte man f\u00fcr den Betrieb eines Raspberry Pi zwingend eine microSD-Karte – seit einiger Zeit kann man auch andere Start-Medien, z.B. einen USB-Stick, verwenden. Meine Erfahrungen mit hochwertigen SD-Karten sind aber ganz gut, so dass ich pers\u00f6nlich dabei bleibe. PDF-Dokumente nehmen meist nicht viel Raum ein, so dass eigentlich eine SD-Karte ab 16 GB reichen w\u00fcrde. Empfehlenswert ist aber eine Gr\u00f6\u00dfe von mindestens 32 GB, lieber 64 GB und mehr. Dann ist auch gen\u00fcgend Platz f\u00fcr Export- und Backup-Vorhaben.<\/p>\n\n\n\n

Vorbereitung: Falls Docker noch nicht vorhanden<\/h2>\n\n\n\n

Sofern man bereits mit Docker arbeitet, kann dieser Abschnitt \u00fcbersprungen werden, dann direkt zu „Installation mit Docker-Compose“ gehen. Alle folgenden Befehle werden im Terminal ausgef\u00fchrt. Dieses also aufrufen und die Befehle einfach per Kopierfunktion \u00fcbertragen. Diesen Abschnitt halte ich kurz, bei der eigentlichen Installation kommen einige Erl\u00e4uterungen.<\/p>\n\n\n\n

<\/path><\/path><\/svg><\/span>
curl<\/span> <\/span>-fsSL<\/span> <\/span>https:\/\/get.Docker.com<\/span> <\/span>-o<\/span> <\/span>get-Docker.sh<\/span> <\/span>&&<\/span> <\/span>chmod<\/span> <\/span>+x<\/span> <\/span>get-Docker.sh<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Die Ausf\u00fchrung des n\u00e4chsten Befehls dauert ein wenig, also 1, 2 Minuten warten:<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
sudo<\/span> <\/span>.\/get-Docker.sh<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Im Beispiel ist der Nutzername „pi“ – sofern ein anderer verwendet wird, den Namen austauschen:<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
sudo<\/span> <\/span>usermod<\/span> <\/span>-aG<\/span> <\/span>docker<\/span> <\/span>pi<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Der folgende Befehl wird eigentlich erst nach einem Neustart wirksam, zahlt sich sp\u00e4ter aus, jetzt m\u00fcssen wir nicht neu booten: <\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
cat<\/span> <\/span>\/etc\/group<\/span> <\/span>|<\/span> <\/span>grep<\/span> <\/span>docker<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Und noch:<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
newgrp<\/span> <\/span>docker<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Damit sind die Vorbereitungen eigentlich fertig. Wenn man m\u00f6chte, kann man einen kurzen Test machen, ob Docker reagiert:<\/p>\n\n\n\n
<\/path><\/path><\/svg><\/span>
docker<\/span> <\/span>run<\/span> <\/span>hello-world<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Da kommen jetzt ein paar S\u00e4tze, wenn alles korrekt l\u00e4uft.<\/p>\n\n\n\n
Installation mit Docker-Compose*<\/h2>\n\n\n\n
\n
*) Hinweis: Inzwischen wurde der urspr\u00fcnglich getrennte Befehl „docker-compose“ in Docker integriert, so dass die zus\u00e4tzliche Installation nicht mehr notwendig ist. Der Befehle wird jetzt ohne Bindestrich<\/strong> geschrieben = 
„docker compose“. 
Darauf bei der nachfolgenden Installation bitte achten.<\/p>\n<\/blockquote>\n\n\n\n
Nun zur eigentlichen Installation: Zun\u00e4chst m\u00fcssen wir „docker-compose“ auf dem Raspberry Pi installieren – das erledigt die folgende Zeile. (W\u00e4hrend des Vorgangs h\u00e4lt das Skript kurz an und fragt „no\/yes“ – dann einfach „y“ eingeben und Enter.)<\/em><\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
sudo<\/span> <\/span>apt<\/span> <\/span>install<\/span> <\/span>docker<\/span>-<\/span>compose<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Optional: <\/strong>Man kann seinen Nutzernamen (im Beispiel „pi“) noch kurz in die Berechtigungsgruppe „docker“ aufnehmen lassen, dann spart man sich sp\u00e4ter gelegentlich ein „sudo“ oder „sudo su“. Falls man das macht, so muss man sich danach kurz neu anmelden oder die Raspberry Pi neu starten, damit die Berechtigung zugewiesen wird.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
sudo<\/span> <\/span>usermod<\/span> <\/span>-<\/span>aG<\/span> <\/span>docker<\/span> <\/span>pi<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Das Installationsskript ausf\u00fchren<\/h3>\n\n\n\n
Jetzt wird ein Skript geladen und ausgef\u00fchrt. Dabei werden ein paar Punkte abgefragt, die gleich noch beschrieben werden. Die Zeile wird ohne „sudo“<\/strong> eingegeben, die darin aufgef\u00fchrten Anf\u00fchrungszeichen m\u00fcssen erhalten bleiben: <\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
bash<\/span> <\/span>-<\/span>c<\/span> <\/span>"<\/span>$(curl -L https:\/\/raw.githubusercontent.com\/paperless-ngx\/paperless-ngx\/main\/install-paperless-ngx.sh)<\/span>"<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Die Abfragen<\/h3>\n\n\n\n
Zeile f\u00fcr Zeile erscheinen Abfragen mit vorgegebenen Werten, die man eigentlich nur durch Return best\u00e4tigen muss. An zwei, drei Stellen sollten Anpassungen vorgenommen werden. Im Beispiel wird davon ausgegangen, dass man den Benutzernamen „pi“ verwendet (falls Udo oder PipiLangstrumpf – dann entsprechend ersetzen): <\/p>\n\n\n\n