====== Paperless-ngx ======

===== Installation =====

  * [[https://docs.paperless-ngx.com/setup/|Installation & Setup]]
  * [[https://docs.paperless-ngx.com/setup/#docker_script|Docker using the Installation Script]]

<code ->
bash -c "$(curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"

</code>


===== Backup erstellen und einspielen =====


==== Auf der Quell-Installation ====

  - In einem beliebigen Unterordner wechseln z.b **%%~/paperless-ngx/consume%%**
  - dort ''sudo docker compose exec webserver document_exporter ../export/''
  - Export-Datei packen.''tar -cvzf export.tgz export''

==== Auf der Ziel-Installation ====

Die Ziel-Installation **muss**

  * den gleichen Versionsstand aufweisen wie die Quell-Installation
  * absolut leer sein, d.h. keine Dokumente, insbesondere keine User. Ggf. User unter Einstellungen löschen.

  - in den Ordner %%**~/paperless-ngx** gehen%%
  - die Export-Datei holen, z.B.''scp cs@192.168.178.41:/home/cs/paperless-ngx/export.tgz .''
  - die Export-Datei entpacken ''tar -xzf export.tgz' wird automatisch in das export Verzeichnis entpackt   - ins exort Verzeichnis (oder anderes Unterverzeichnis wechseln)   - dort ''sudo docker compose exec webserver document_importer ../export'' ausführen

Die Dateien und alle User werden übernommen. Auf der Anmeldemaske mit dem/einem User aus der Quell-Installation anmelden. Fertig!


===== Consume Folder mounten (samba) =====

  * [[https://www.youtube.com/watch?v=69zhCTa7Zc4|Paperless-ngx Using Docker With A Shared Consume Folder]]
  * [[https://linuxconfig.org/how-to-mount-a-samba-shared-directory-at-boot|How to mount a Samba shared directory at boot]]


Create the superuser:

<code ->
docker-compose run --rm webserver createsuperuser
</code>

Install samba:

<code ->
sudo apt-get install samba -y
</code>

Confirm service is running:

<code ->
 sudo systemctl restart smbd.service
</code>

Add new user:

<code ->
sudo adduser  paperless
</code>

Add the user to samba:

<code ->
sudo smbpasswd -a paperless
</code>

Set permissions:

<code ->
sudo apt-get install acl 
</code>

<code ->
sudo setfacl -R -m "u:paperless:rwx" /path/to/paperless/consumption/directory
</code>

Samba.conf to add share folder to:

<code ->
sudo nano /etc/samba/smb.conf
</code>

Sample Samba share:

<code ->
[paperless]
    comment = paperless consumption
    path = /path/to/paperless/consumption/directory
    read only = no
    writable = yes
    browseable = yes
    guest ok = no
    valid users = @paperless
<code ->
sudo mount -t cifs  -o username=paperless  //192.168.178.41/paperless /home/cs/paperless-consume 
</code>

Eintrag in /etc/fstab

<code ->
//192.168.178.41/paperless /home/cs/paperless-consume cifs rw,username=cs,password=19cs12,uid=1000,noforceuid,gid=1000,noforcegid,file_mode=0755,dir_mode=0755 0 0
</code>