{"id":835,"date":"2025-12-09T23:07:19","date_gmt":"2025-12-09T22:07:19","guid":{"rendered":"https:\/\/www.lemix.de\/?p=835"},"modified":"2025-12-09T23:07:19","modified_gmt":"2025-12-09T22:07:19","slug":"paperless-ngx-ordnerfreigabe-per-smb-samba-im-proxmox-lxc-einrichten","status":"publish","type":"post","link":"https:\/\/lemix.de\/index.php\/2025\/12\/09\/paperless-ngx-ordnerfreigabe-per-smb-samba-im-proxmox-lxc-einrichten\/","title":{"rendered":"Paperless-ngx: Ordnerfreigabe per SMB (Samba) im Proxmox LXC einrichten"},"content":{"rendered":"\n

Wenn Sie Paperless-ngx in einem LXC-Container unter Proxmox betreiben, kann das Hochladen von Dokumenten \u00fcber die Weboberfl\u00e4che m\u00fchsam sein. Mit dieser Anleitung richten Sie eine SMB-Freigabe ein, um Dokumente direkt in den consume<\/code>-Ordner zu ziehen und die archivierten Originale bequem einzusehen.<\/p>\n\n\n\n

Diese Anleitung setzt voraus, dass Sie sich per SSH mit Ihrem Paperless-ngx LXC-Container verbinden k\u00f6nnen.<\/p>\n\n\n\n

\ud83d\udee0\ufe0f 1. Installation und Vorbereitung im LXC<\/h2>\n\n\n\n

Der erste Schritt ist die Installation des Samba-Dienstes im Paperless-ngx Container.<\/p>\n\n\n\n

1.1 Samba installieren<\/h3>\n\n\n\n

Verbinden Sie sich mit Ihrem LXC und installieren Sie die notwendigen Pakete:<\/p>\n\n\n\n

sudo apt update\nsudo apt install samba -y<\/code><\/pre>\n\n\n\n
1.2 Samba-Benutzer anlegen<\/h3>\n\n\n\n
Wir erstellen einen dedizierten Benutzer f\u00fcr den SMB-Zugriff. Wir nennen ihn hier smbuser<\/code>.<\/p>\n\n\n\n
    \n
  1. Linux-Benutzer erstellen:<\/strong>Bashsudo adduser smbuser --disabled-password<\/code><\/li>\n\n\n\n
  2. Samba-Passwort festlegen:<\/strong> Dieses Passwort wird f\u00fcr die Anmeldung \u00fcber SMB ben\u00f6tigt.Bashsudo smbpasswd -a smbuser <\/code>Geben Sie das gew\u00fcnschte Passwort ein und wiederholen Sie es.<\/li>\n\n\n\n
  3. Benutzer zur Paperless-Gruppe hinzuf\u00fcgen:<\/strong> Der Paperless-ngx-Dienst l\u00e4uft unter einem bestimmten Benutzer\/Gruppe (oft paperless<\/code>). Der SMB-Benutzer muss dieser Gruppe angeh\u00f6ren, um Schreibrechte zu erhalten.Bashsudo usermod -aG paperless smbuser<\/code><\/li>\n<\/ol>\n\n\n\n
    \u2699\ufe0f 2. Konfiguration der SMB-Freigaben<\/h2>\n\n\n\n
    Nun passen wir die Samba-Konfigurationsdatei an, um die Freigaben f\u00fcr den consume<\/code>– und den originals<\/code>-Ordner zu definieren.<\/p>\n\n\n\n
    2.1 Konfigurationsdatei \u00f6ffnen<\/h3>\n\n\n\n
    \u00d6ffnen Sie die Samba-Konfiguration im Editor (z.B. nano<\/code>):<\/p>\n\n\n\n
    sudo nano \/etc\/samba\/smb.conf<\/code><\/pre>\n\n\n\n
    2.2 Optimierte Freigaben hinzuf\u00fcgen<\/h3>\n\n\n\n
    F\u00fcgen Sie die folgenden Abschnitte ganz am Ende der Datei<\/strong> hinzu. Diese Konfiguration stellt sicher, dass der consume<\/code>-Ordner Schreibrechte hat und neue Dateien automatisch die Gruppe paperless<\/code> erben.<\/p>\n\n\n\n
    \n
    Wichtig:<\/strong> Ersetzen Sie smbuser<\/code> durch den Benutzernamen, den Sie in Schritt 1.2 verwendet haben.<\/p>\n<\/blockquote>\n\n\n\n
    # --- Freigabe zum Ablegen neuer Dokumente (Lese- & Schreibzugriff) ---\n[paperless-consume]\ncomment = Paperless Consume Share (Dropzone)\npath = \/opt\/paperless_data\/consume\nvalid users = smbuser @paperless\nforce group = +paperless\npublic = no\nwritable = yes\ncreate mask = 0664\ndirectory mask = 2775\nprintable = no\n\n# --- Freigabe zur Einsicht archivierter Originale (Nur Lesezugriff) ---\n[paperless-originals]\ncomment = Paperless Originals PDF Share (Read-Only)\npath = \/opt\/paperless_data\/media\/documents\/originals\nvalid users = smbuser @paperless\nforce group = +paperless\npublic = no\nwritable = no\ncreate mask = 0644\ndirectory mask = 2775\nprintable = no<\/code><\/pre>\n\n\n\n
    Speichern und schlie\u00dfen Sie die Datei (STRG+O<\/code>, ENTER<\/code>, STRG+X<\/code> in nano<\/code>).<\/p>\n\n\n\n
    \ud83d\udd12 3. Linux-Dateirechte korrigieren<\/h2>\n\n\n\n
    Damit der SMB-Dienst und sp\u00e4ter Paperless-ngx reibungslos zusammenarbeiten, m\u00fcssen die Linux-Berechtigungen auf dem Ordner korrekt gesetzt werden.<\/p>\n\n\n\n
    3.1 Berechtigungen f\u00fcr den consume<\/code>-Ordner<\/h3>\n\n\n\n
    Wir setzen das Set GID Bit (2<\/code>)<\/strong> und geben dem Besitzer (7<\/code>)<\/strong> und der Gruppe (7<\/code>)<\/strong> Schreibrechte (775<\/code>). Dies stellt sicher, dass der Paperless-Dienst die von Samba erstellten Dateien verarbeiten kann.<\/p>\n\n\n\n
    # 1. Sicherstellen, dass der Ordner der Gruppe \"paperless\" geh\u00f6rt\nsudo chown -R paperless:paperless \/opt\/paperless_data\/consume\n\n# 2. Schreibrechte f\u00fcr Gruppe und Set GID Bit setzen (2775)\nsudo chmod 2775 \/opt\/paperless_data\/consume<\/code><\/pre>\n\n\n\n
    3.2 Berechtigungen f\u00fcr den originals<\/code>-Ordner<\/h3>\n\n\n\n
    Auch hier stellen wir sicher, dass die Gruppe Leserechte hat:<\/p>\n\n\n\n
    sudo chown -R paperless:paperless \/opt\/paperless_data\/media\/documents\/originals\nsudo chmod 2775 \/opt\/paperless_data\/media\/documents\/originals<\/code><\/pre>\n\n\n\n
    \ud83c\udfc1 4. Abschluss und Test<\/h2>\n\n\n\n
    Starten Sie den Samba-Dienst neu, um alle Konfigurations\u00e4nderungen zu \u00fcbernehmen.<\/p>\n\n\n\n
    sudo systemctl restart smbd<\/code><\/pre>\n\n\n\n
    4.1 Testen des Zugriffs<\/h3>\n\n\n\n
    Greifen Sie nun von Ihrem Client-PC (Windows, Mac, Linux) auf die IP-Adresse Ihres LXC-Containers zu:<\/p>\n\n\n\n
      \n
    • Windows:<\/strong> Geben Sie \\\\IP_IHRES_LXC<\/code> in die Adressleiste des Explorers ein.<\/li>\n\n\n\n
    • macOS\/Linux:<\/strong> Gehen Sie zu smb:\/\/IP_IHRES_LXC<\/code> im Dateimanager.<\/li>\n<\/ul>\n\n\n\n
      Melden Sie sich mit dem Benutzer smbuser<\/code><\/strong> und dem Samba-Passwort<\/strong> an.<\/p>\n\n\n\n
      Sie sollten nun die Freigaben paperless-consume<\/code><\/strong> (zum Hochladen) und paperless-originals<\/code><\/strong> (zum Lesen) sehen k\u00f6nnen.<\/p>\n","protected":false},"excerpt":{"rendered":"
      Wenn Sie Paperless-ngx in einem LXC-Container unter Proxmox betreiben, kann das Hochladen von Dokumenten \u00fcber die Weboberfl\u00e4che m\u00fchsam sein. Mit […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[6,3],"tags":[],"class_list":["post-835","post","type-post","status-publish","format-standard","hentry","category-proxmox","category-tutorials"],"_links":{"self":[{"href":"https:\/\/lemix.de\/index.php\/wp-json\/wp\/v2\/posts\/835","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lemix.de\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lemix.de\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lemix.de\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lemix.de\/index.php\/wp-json\/wp\/v2\/comments?post=835"}],"version-history":[{"count":0,"href":"https:\/\/lemix.de\/index.php\/wp-json\/wp\/v2\/posts\/835\/revisions"}],"wp:attachment":[{"href":"https:\/\/lemix.de\/index.php\/wp-json\/wp\/v2\/media?parent=835"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lemix.de\/index.php\/wp-json\/wp\/v2\/categories?post=835"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lemix.de\/index.php\/wp-json\/wp\/v2\/tags?post=835"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}