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

Vorlage:Infobox

2026-10-23T17:25:41Z

Robin Tönniges: Dunkelmodus: Farben über Vector-2022-Variablen

<onlyinclude>{| class="float-right infobox toptextcells {{#switch: {{{Stil}}}
| 2 = " cellspacing="5"
| #default = wikitable"
}} style="font-size:95%; text-align:left; {{#ifeq:{{{Stil}}}|2|border:1px solid var(--border-color-base, #a2a9b1); background-color: var(--background-color-neutral-subtle, #f8f9fa); color: var(--color-base, #202122); padding:2px;}} {{#if: {{{Style|}}} | {{{Style}}} | min-width:190px; max-width:260px; width:30%;}}"<noinclude>
|+ Beispiel:</noinclude>
|- style="font-size:110%; text-align:center;"
! colspan="2" class="hintergrundfarbe{{{Titelfarbe|6}}}" style="padding-left:0.5em; padding-right:0.5em; {{#if: {{{Farbe|}}} | background:{{{Farbe}}};}}" | {{#if: {{{Titel|}}} | {{{Titel}}} | {{PAGENAME}} }}
|- style="text-align:center;"
{{#if: {{{Bildname<includeonly>|</includeonly>}}} |
{{!}} colspan="2" aria-hidden="true" role="presentation" {{!}} [[Datei:{{{Bildname}}}|{{#if: {{{Bildbreite|}}} | {{{Bildbreite}}} | frameless }}|border|{{{Bildtext<includeonly>|{{PAGENAME}}</includeonly>}}}]] {{{Bildtext<includeonly>|{{PAGENAME}}</includeonly>}}}
| {{#if: {{{Bild|}}} |
{{!}} colspan="2" {{!}} {{{Bild}}} {{#if: {{{Bildtext|}}} | {{{Bildtext}}} }}[[Vorlage:Infobox/Wartung/Bild]] }}
}}
{{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname1<includeonly>|{{{1|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten1<includeonly>|{{{2|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname2<includeonly>|{{{3|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten2<includeonly>|{{{4|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname3<includeonly>|{{{5|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten3<includeonly>|{{{6|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname4<includeonly>|{{{7|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten4<includeonly>|{{{8|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname5<includeonly>|{{{9|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten5<includeonly>|{{{10|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname6<includeonly>|{{{11|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten6<includeonly>|{{{12|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname7<includeonly>|{{{13|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten7<includeonly>|{{{14|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname8<includeonly>|{{{15|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten8<includeonly>|{{{16|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname9<includeonly>|{{{17|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten9<includeonly>|{{{18|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname10<includeonly>|{{{19|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten10<includeonly>|{{{20|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname11<includeonly>|{{{21|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten11<includeonly>|{{{22|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname12<includeonly>|{{{23|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten12<includeonly>|{{{24|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname13<includeonly>|{{{25|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten13<includeonly>|{{{26|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname14<includeonly>|{{{27|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten14<includeonly>|{{{28|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname15<includeonly>|{{{29|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten15<includeonly>|{{{30|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname16<includeonly>|{{{31|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten16<includeonly>|{{{32|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname17<includeonly>|{{{33|}}}</includeonly>}}}
| Text = {{{Daten17<includeonly>|{{{34|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname18<includeonly>|{{{35|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten18<includeonly>|{{{36|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname19<includeonly>|{{{37|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten19<includeonly>|{{{38|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname20<includeonly>|{{{39|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten20<includeonly>|{{{40|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname21<includeonly>|{{{41|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten21<includeonly>|{{{42|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname22<includeonly>|{{{43|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten22<includeonly>|{{{44|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname23<includeonly>|{{{45|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten23<includeonly>|{{{46|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname24<includeonly>|{{{47|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten24<includeonly>|{{{48|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname25<includeonly>|{{{49|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten25<includeonly>|{{{50|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname26<includeonly>|{{{51|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten26<includeonly>|{{{52|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname27<includeonly>|{{{53|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten27<includeonly>|{{{54|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname28<includeonly>|{{{55|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten28<includeonly>|{{{56|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname29<includeonly>|{{{57|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten29<includeonly>|{{{58|}}}</includeonly>}}}
}} {{Infobox/+
| Stil = {{{Stil|}}}
| Farbe = {{{Abschnittsfarbe|}}}
| Farbe alt = {{{Farbe|}}}
| Label = {{{Feldname30<includeonly>|{{{59|}}}</includeonly>}}}
| Labelart = {{{Feldstyle|}}}
| Text = {{{Daten30<includeonly>|{{{60|}}}</includeonly>}}}
}}
|}</onlyinclude>

{{Dokumentation|TOC=1}}

MediaWiki:Common.css

2026-10-23T17:25:39Z

Robin Tönniges: Dunkelmodus: Farben über Vector-2022-Variablen

/*----------------------------------------------------------------------------------------------*/
/* ACHTUNG! Common.css enthält die gemeinsamen Skin-Anpassungen der deutschsprachigen Wikipedia */
/*----------------------------------------------------------------------------------------------*/

/*----------------------------------------------------------------------------------------------*/
/* ACHTUNG! MediaWiki:Common.css steht in der mobilen Version nicht zur
* Verfügung. Anpassungen müssen ggf. separat in MediaWiki:Mobile.css übernommen werden. */
/*----------------------------------------------------------------------------------------------*/

/*
* Common.css ist in zwei grundlegende Abschnitte gegliedert:
*
* 1. Anpassungen der Anzeige von editierbaren Seiteninhalten
* (a) Definitionen projektweiter Klassen und IDs
* (b) Fußnoten
* (c) HTML-Elemente
* 2. Anpassungen der Bedienoberfläche
* (a) Anpassungen für die Flagged-Revisions-Erweiterung
* (b) Unsortierte Anpassungen
*
* Jede Ergänzung/Änderung muss vorher jeweils für alle Skins auf Tauglichkeit
* getestet werden, individuell per [[Special:Mypage/common.css]]! Ist hier
* erstmal geändert, dauert es dank Cache eine Weile, bis die Änderungen bei
* allen Nutzern sichtbar oder, bei Fehlern, korrigiert sind.
*
* Insbesondere innerhalb des Abschnitts 1. (a) ist die Reihenfolge der Regeln
* wichtig, weil die dort definierten Klassen kombiniert werden können.
*/

/* +++++ 1. ANPASSUNGEN DER ANZEIGE VON EDITIERBAREN SEITENINHALTEN +++++ */

/* +++++ 1. (a) DEFINITIONEN PROJEKTWEITER KLASSEN UND IDS +++++ */

/* Personennamen in Kapitälchen */
.Person {
font-variant: small-caps;
}

/*
* Stylesheet-Ergänzung zu Standard-Navigationsleisten:
* [[Hilfe:Navigationsleisten]], [[Vorlage:Navigationsleiste]]
*/
div.NavFrame {
border: 1px solid #a2a9b1;
clear: both;
font-size: 95%;
margin-top: 1.5em;
min-height: 0; /* IE 7 */
padding: 2px;
text-align: center;
}
div.NavPic {
float: left;
padding: 2px;
}
div.NavHead {
background: #eaecf0;
font-weight: bold;
}
div.NavFrame:after {
clear: both;
content: "";
display: block;
}

/*
* Stylesheet für den „Ausklappen“-Button an Navigationsleisten, der in
* [[MediaWiki:Common.js]] implementiert wird
*/
.NavToggle {
float: right;
font-size: x-small;
}

/* Automatisches Verschmelzen benachbarter Navigationsleisten */
div.NavFrame + div.NavFrame {
margin-top: -1px;
}

/*
* Verschmelzen mittels [[Vorlage:NaviBlock]]
* Im Gegensatz zum automatischen Verschmelzen gibt es bei dieser Variante keine
* Trennlinie zwischen den Leisten. Möglicherweise war dies ursprünglich nur ein
* IE-6-Workaround, da das automatische Verschmelzen im IE 6 nicht funktioniert.
*/
div.BoxenVerschmelzen {
border: 1px solid #a2a9b1;
clear: both;
font-size: 95%;
margin-top: 1.5em;
padding-top: 2px;
}
div.BoxenVerschmelzen div.NavFrame {
border: none;
font-size: 100%;
margin: 0;
padding-top: 0;
}

/*
* VERALTET: Ehemals [[Vorlage:Prettytable]], jetzt infolge von [[rev:48842]]
* Kopie der Klasse „wikitable“ aus mediawiki.legacy/shared.css bis auf die
* Einfärbung der Kopfzellen.
* Die Existenz zweier Klassennamen ist aus [[:en:MediaWiki:Common.css]] geerbt,
* vgl. https://en.wikipedia.org/w/index.php?diff=26977467&oldid=26934973
* und https://en.wikipedia.org/w/index.php?diff=361917988&oldid=358750840.
* Es gab im Jahr 2007 einen Botlauf zur Umstellung der Vorlage auf CSS,
* dokumentiert unter [[Vorlage Diskussion:Prettytable/Bugs]] (gelöscht). Dabei
* wurde leider der „falsche“ Klassenname gewählt.
* Da die Vorlage keine farblichen Hervorhebungen hatte, es deshalb zahlreiche
* Einbindungen mit individuell eingefärbten Kopfzeilen gibt und die Einfärbung
* der Kopfzellen diese verdecken würde, wurde hier auf die Einfärbung der
* Kopfzellen verzichtet.
*/
.prettytable {
background-color: var(--background-color-neutral-subtle, #f8f9fa);
border: 1px solid var(--border-color-base, #a2a9b1);
border-collapse: collapse;
color: var(--color-base, black);
margin: 1em 0;
}
table.prettytable > * > tr > th,
table.prettytable > * > tr > td {
border: 1px solid #a2a9b1;
padding: .2em .4em;
}
table.prettytable > * > tr > th {
/* background-color: #eaecf0; */
text-align: center;
}
table.prettytable > caption {
font-weight: bold;
}

/* Temporäres Vergrämen aus dem ANR */
.ns-0 table.prettytable::before {
background-color: #ffff00;
content: "class=prettytable ist veraltet, wikitable verwenden";
color: #FF0000;
}
.ns-0 .prettytable {
background-color: #ff69b4;
border: 1em solid #ff0000;
}
.ns-0 table.prettytable > * > tr > th,
.ns-0 table.prettytable > * > tr > td {
border: 1em solid #ff0000;
}

/*
* Zebra-Tabellen. Bei Verwendung zusammen mit „rowspan“ richtet sich die Farbe
* jeder Zelle nach der ersten Zeile, zu der die Zelle gehört.
*/
table.wikitable.zebra > tbody > :nth-child(even):not([class*="hintergrundfarbe"]) {
background: var(--background-color-base, white);
}

/*
* Klassen für die Ausrichtung von Bausteinen, Tabellen, mit „gallery“-Tags
* realisierten Bildergalerien und weiteren Objekten.
* Vorsicht: Das MediaWiki-eigene CSS enthält Klassen mit den sehr ähnlichen
* Namen „floatleft“, „floatright“ und „center“, deren Definitionen sich aber
* von den lokalen Definitionen unterscheiden.
* Für die Bedeutung der „noflip“-Kommentare siehe
* [[mw:ResourceLoader/Features#Flipping]].
*/

/* @noflip */
div.float-left,
table.float-left,
ul.float-left,
.float-left {
clear: left;
float: left;
margin: 1em 1em 1em 0;
}
/* @noflip */
div.float-right,
table.float-right,
ul.float-right,
.float-right {
clear: right;
float: right;
margin: 1em 0 1em 1em;
}
div.centered,
table.centered,
ul.centered,
.centered {
margin-left: auto;
margin-right: auto;
}

/*
* Obenbündige Textausrichtung in Tabellen. Wirkt nicht auf Kopfzellen und wurde
* unter anderem wegen Inkonsistenzen bei sortierbaren Tabellen nicht auf
* Kopfzellen ausgeweitet.
*/
.toptextcells > * > * > td {
vertical-align: top;
}

/*
* Farbdefinitionen für Rahmen und Hintergründe von Textbausteinen:
* [[Wikipedia:Textbausteine]]; Anpassungen für andere Skins sind optional.
* (Die Angaben der Rahmenstärke dienen der Bequemlichkeit, so dass man
* für dünne Rahmen nur noch „border-style“ angeben muss.)
*/

/* Wie Inhaltsverzeichnis (mediawiki.skinning/content.css) */
.rahmenfarbe1 {
border: 1px #a2a9b1;
}
/* Unauffällig, geringer Kontrast */
.rahmenfarbe2 {
border: 1px #eaecf0;
}
/* „Rot“, auffällig */
.rahmenfarbe3 {
border: 1px #c00000;
}
/* Neutrale Farbe, deutlich */
.rahmenfarbe4 {
border: 1px #88a;
}
/* „Schwarz“, hoher Kontrast */
.rahmenfarbe5 {
border: 1px #000;
}

/* Wie Inhaltsverzeichnis (mediawiki.skinning/content.css) */
table > * > tr.hintergrundfarbe1 > th,
table > * > tr > th.hintergrundfarbe1,
table.hintergrundfarbe1,
.hintergrundfarbe1 {
background-color: var(--background-color-neutral-subtle, #f8f9fa);
}
/* „Weiß“, für Nicht-Artikel-Seiten, neutral */
table > * > tr.hintergrundfarbe2 > th,
table > * > tr > th.hintergrundfarbe2,
table.hintergrundfarbe2,
.hintergrundfarbe2 {
background-color: var(--background-color-base, #fff);
}
/* „Gelb“, auffällig */
table > * > tr.hintergrundfarbe3 > th,
table > * > tr > th.hintergrundfarbe3,
table.hintergrundfarbe3,
.hintergrundfarbe3 {
background-color: #ffff40;
color: #202122; /* Dunkelmodus: farbiger Hintergrund bleibt hell */
}
/* Sehr auffällig */
table > * > tr.hintergrundfarbe4 > th,
table > * > tr > th.hintergrundfarbe4,
table.hintergrundfarbe4,
.hintergrundfarbe4 {
background-color: #fa0;
color: #202122; /* Dunkelmodus: farbiger Hintergrund bleibt hell */
}
/* Neutral, abgesetzt */
table > * > tr.hintergrundfarbe5 > th,
table > * > tr > th.hintergrundfarbe5,
table.hintergrundfarbe5,
.hintergrundfarbe5 {
background-color: var(--background-color-neutral, #eaecf0);
}
/* Allgemein „bunt“, für Hervorhebungen und Unterscheidungen */
table > * > tr.hintergrundfarbe6 > th,
table > * > tr > th.hintergrundfarbe6,
table.hintergrundfarbe6,
.hintergrundfarbe6 {
background-color: #b3b7ff;
color: #202122; /* Dunkelmodus: farbiger Hintergrund bleibt hell */
}
/* Allgemein „bunt“, für Hervorhebungen und Unterscheidungen */
table > * > tr.hintergrundfarbe7 > th,
table > * > tr > th.hintergrundfarbe7,
table.hintergrundfarbe7,
.hintergrundfarbe7 {
background-color: #ffcbcb;
color: #202122; /* Dunkelmodus: farbiger Hintergrund bleibt hell */
}
/* Allgemein „bunt“, für Hervorhebungen und Unterscheidungen */
table > * > tr.hintergrundfarbe8 > th,
table > * > tr > th.hintergrundfarbe8,
table.hintergrundfarbe8,
.hintergrundfarbe8 {
background-color: #ffebad;
color: #202122; /* Dunkelmodus: farbiger Hintergrund bleibt hell */
}
/* Allgemein „bunt“, für Hervorhebungen und Unterscheidungen */
table > * > tr.hintergrundfarbe9 > th,
table > * > tr > th.hintergrundfarbe9,
table.hintergrundfarbe9,
.hintergrundfarbe9 {
background-color: #b9ffc5;
color: #202122; /* Dunkelmodus: farbiger Hintergrund bleibt hell */
}

/* Dunkelmodus: Links auf hell bleibenden, farbigen Hintergründen in Tagfarben */
.hintergrundfarbe3 a, .hintergrundfarbe4 a, .hintergrundfarbe6 a,
.hintergrundfarbe7 a, .hintergrundfarbe8 a, .hintergrundfarbe9 a {
color: #36c;
}
.hintergrundfarbe3 a.new, .hintergrundfarbe4 a.new, .hintergrundfarbe6 a.new,
.hintergrundfarbe7 a.new, .hintergrundfarbe8 a.new, .hintergrundfarbe9 a.new {
color: #d73333;
}

/*
* Metadaten, bspw. [[Hilfe:Personendaten|Personendaten]]; vgl.
* [[MediaWiki:Gadget-Personendaten.css]].
* Der Klassenname „metadata“ wird in der englischen Wikipedia traditionell für
* einen anderen Zweck verwendet, nämlich für „Elemente in Artikeln, die nicht
* als Teil des eigentlichen Artikelinhalts angesehen werden“, aber auch nicht
* standardmäßig ausgeblendet sind, sondern nur in „alternativen Ansichten“,
* vgl. [[:en:Wikipedia:Catalogue of CSS classes]].
* Das führt zu Nebenwirkungen, zum Beispiel ignoriert der MediaViewer Bilder in
* Bereichen mit dieser Klasse, weil er davon ausgeht, dass es sich um einen
* Wartungsbaustein mit schmückenden Icons wie [[:en:Template:Refimprove]]
* handelt, vgl. [[phab:rEMMV21549d754747681a2b50b8763996b7abf0f4efd5]].
*/
.metadata {
display: none;
}

/* <noscript>-Emulation, vgl. [[phab:T47731]] */
.client-js .noscript {
display: none;
}

/*
* Skinabhängige absolute Positionierungen ausblenden
* Bitte [[MediaWiki Diskussion:Common.css/Archiv/1#Absolute Positionierungen]]
* beachten
*/
#mw-content-text #coordinates,
#mw-content-text #editcount,
#mw-content-text #shortcut,
body.ns-special #mw-content-text .specialpage-helplink {
display: none;
}

/* +++++ 1. (b) FUSSNOTEN +++++ */

/* Vererbung von Hervorhebungen auf Einzelnachweise verhindern */
sup.reference {
font-style: normal;
font-weight: normal;
}

/* Hochgestellte Buchstaben in der Einzelnachweiseliste kursiv setzen */
ol.references li a[href|="#cite_ref"] {
font-style: italic;
}

/*
* Verwendung der Schwesterprojektverweise in Einzelnachweisen:
* [[:Kategorie:Vorlage:Schwesterprojektverweis]]
*/
ol.references li div.sisterproject {
display: inline;
}

/* +++++ 1. (c) HTML-ELEMENTE +++++ */

/*
* Bei URLs, die auf unser Projekt und verwandte Projekte verweisen, den Pfeil
* ausblenden. Dieser Pfeil dient nur dazu, auf externe Ziele hinzuweisen. Auf
* den Einsatz der Klasse „plainlinks“ kann dadurch verzichtet werden.
* März 2016: Die hohe Selektorenspezifität ist für den Modern-Skin nötig.
*/
#mw-content-text a.external[href^="//de.wikipedia.org"],
#mw-content-text a.external[href^="http://de.wikipedia.org"],
#mw-content-text a.external[href^="https://de.wikipedia.org"],
#mw-content-text a.external[href^="//www.wikidata.org"],
#mw-content-text a.external[href^="http://www.wikidata.org"],
#mw-content-text a.external[href^="https://www.wikidata.org"],
#mw-content-text a.external[href*=".toolforge.org/"],
#mw-content-text a.external[href^="//tools.wmflabs.org"],
#mw-content-text a.external[href^="http://tools.wmflabs.org"],
#mw-content-text a.external[href^="https://tools.wmflabs.org"] {
background-image: none;
padding-right: 0;
}

/*
* Unterstrichelung für Abkürzungen weniger aufdringlich als vorgegeben, damit
* die Auszeichnungen nicht wegen Aufdringlichkeit entfernt werden.
* März 2016: Firefox >= 36 benutzt „text-decoration“, alle anderen Rendering-
* Engines benutzen „border-bottom“, vgl. Regel in mediawiki.legacy/shared.css,
* https://bugs.chromium.org/p/chromium/issues/detail?id=665898 sowie
* https://bugs.webkit.org/show_bug.cgi?id=58491
*/
abbr[title]:not(:hover),
.explain[title]:not(:hover) {
border-bottom-color: rgba(50%, 50%, 50%, .5);
text-decoration-color: rgba(50%, 50%, 50%, .5);
}

/*
* blockquote-Styling (grauer Rand links) lokal überschreiben,
* führt u.a. zu unschöner Darstellung bei linksfließenden Elementen,
* vgl. [[phab:T265947]] und [[Special:Permalink/205770389#blockquote_durch_MediaWiki.css]]
*/
.mw-body-content blockquote {
border-left: none;
padding: 0;
}

/* +++++ 2. ANPASSUNGEN DER BEDIENOBERFLÄCHE +++++ */

/* +++++ 2. (a) ANPASSUNGEN FÜR DIE FLAGGED-REVISIONS-ERWEITERUNG +++++ */

/* Für den Abgleich: [[phab:diffusion/EFLR/browse/master/frontend/modules]] */

/* Flagged-Revisions-Backlog-Sitenotice */
.fr-watchlist-pending-notice {
background: transparent;
border: none;
margin: 0;
padding: 0;
}

/* Standardmäßige Ausblendung der Flagged-Revisions-Kommentarbox */
.fr-comment-box {
display: none;
}

/* Hintergrund des Sichten-Links auf der Beobachtungsliste entfärben */
.mw-fr-reviewlink {
background: transparent;
}

/*
* Ausklappbarer Teil der Flagged-Revisions-Box im Vordergrund relativ
* positionierter Vorlagen, vor allem [[Vorlage:Positionskarte]]; an
* #mw-fr-revisiondetails-wrapper statt div.flaggedrevs_short_details für IE 7:
* http://web.archive.org/web/therealcrisp.xs4all.nl/meuk/IE-zindexbug.html
*/
#mw-fr-revisiondetails-wrapper {
z-index: 1;
}

/*
* Patrollink, Ausrufezeichen und Legendeneintrag ausblenden und Einträge auf
* [[Spezial:Neue Seiten]] entfärben, da das Feature hier nicht genutzt wird und
* dessen Optik zu sehr den gesichteten Versionen ähnelt; vgl. [[phab:T102818]]
*/
.patrollink,
ul.special .unpatrolled,
.mw-changeslist-legend .unpatrolled,
.mw-changeslist-legend-unpatrolled {
display: none;
}
td.mw-enhanced-rc .unpatrolled {
visibility: hidden;
}
.not-patrolled {
background-color: transparent;
}

/* +++++ 2. (b) UNSORTIERTE ANPASSUNGEN +++++ */

/*
* Rollback-Knopf auf der Beobachtungsliste ausblenden, da er dort nur von sehr
* beschränktem Nutzen ist und zu sehr vielen Reverts aus Versehen führt
*/
.mw-special-Watchlist .mw-rollback-link {
display: none;
}

/*
* Verhindere, dass Infoboxen etc. in den Inhalt von Kategorien hineinragen.
* Das betrifft nur Kategorieseiten.
*/
div.mw-category-generated {
clear: both;
}

/* [[Special:Search]]: Suchergebnisse aus anderssprachigen Wikipedien */
.mw-search-interwiki-header {
border-top: 3px solid #c00000;
}

/* Link [[Spezial:Buch|Buch erstellen]] in Sidebar ausblenden */
#coll-create_a_book {
display: none;
}

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

2026-10-23T15:48:44Z

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.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 sync
</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 uv sync
</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)

2026-10-23T10:30:29Z

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.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
sudo -Hu paperless uv sync
</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
sudo -Hu paperless uv sync
</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: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. 

=== 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. 

=== 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__