brain/04 Ressourcen/IT/Paperless-NGX.md

169 lines
4.1 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
tags:
- upnote-import
---
# Paperless-NGX
![image](https://docs.paperless-ngx.com/assets/logo_full_white.svg#only-dark)<br>
## <br>
## Konfiguration
- IP: 192.168.178.34
- Port: 8000
- Server: Docker Container
- URLs:
- [http://paper.kb:8000/](http://paper.kb:8000/)
- [paper.straso.com](https://paper.straso.com/)
### Config NPM
```yaml
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
# proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Host $server_name;
proxy_intercept_errors on; # the most important directive, make it on;
add_header P3P 'CP=""'; # may not be required in all setups
```
# Update
1. Version notierenaktuelle Version vermerken. Wird benötigt, falls ein Rollback erforderlich sein sollte
2. altes Backup löschen, in /volume1/docker$
```bash
cd /volume1/docker
rm -r paperless_backup/
```
2. Anwendung stoppen in /volume1/docker/paperless$
```
cd paperless
sudo docker-compose down
```
3. neues Backup erstellen, in /volume1/docker$
```
cd ..
sudo cp -r ./paperless ./paperless_backup
```
4. Images löschen, in /volume1/docker/paperless$
```
cd paperless
sudo docker-compose rm -f
```
5. Images Updaten, in /volume1/docker/paperless$
```
sudo docker-compose pull
```
6. Anwendung starten
```
sudo docker-compose up -d
```
### DB-Server-Upgrade
nur den DB Container starten
```
sudo docker-compose up -d db
```
backup script erstellen
```
sudo docker exec -it paperless-db-1 pg_dumpall -U paperless > $HOME/upgrade_paperless_backup.sql
```
…..
[Paperless broke after update | solariz.de - Tech & Thoughts](https://solariz.de/posts/25/paperless-broken-after-upgrade-postgress/#paperless-ngx-postgresql-14-or-later-is-required-error)
außerdem mussten alle volumes einmal zurückgesetzt werden: [\[BUG\] password authentication failed for user "paperless" · Issue #1552 · jonaswinkler/paperless-ng](https://github.com/jonaswinkler/paperless-ng/issues/1552)
```
docker-compose up -V --remove-orphans --force-recreate
```
# <br>
# Updateverlauf
- 2025-09-26: von 2.13.5 auf 2.18.4
## <br>
# Archivierungsworkflow
### Dokumente, die aufbewahrt werden:
189er Etiketten für [ASNs](https://docs.paperless-ngx.com/advanced_usage/#archive-serial-number-assignment):
[https://www.bueroshop24.de/5670-avery-zweckform-etiketten-l4731rev-25-wei%C3%9F-25-4-x-10-0-mm-345520?mkz=724](https://www.bueroshop24.de/5670-avery-zweckform-etiketten-l4731rev-25-wei%C3%9F-25-4-x-10-0-mm-345520?mkz=724)
Tools zum generieren von Barcodes:
[https://tobiasmaier.info/asn-qr-code-label-generator/](https://tobiasmaier.info/asn-qr-code-label-generator/)
### empfohlener Wokflow:
[https://docs.paperless-ngx.com/usage/#usage-recommended-workflow](https://docs.paperless-ngx.com/usage/#usage-recommended-workflow)
### ASN-Definition:
Zähler-Offset:
100189 = Christian
200189 = Vera
300189 = Vicky
400189 = Justus
500189 = Hetti
z.B.: ASN200000,TAG:Vera
# Dokumente exportieren
VoraussetzungVolume für Export-Verzeichnis festlegen
` ``` volumes: - /volume1/docker/paperless/data:/usr/src/paperless/data - /volume1/docker/paperless/media:/usr/src/paperless/media - /volume1/docker/paperless_export:/usr/src/paperless/export # https://paperless.readthedocs.io/en/latest/utilities.html#the-exporter - /volume1/homes/chk/Drive/Paperless-Input:/usr/src/paperless/consume ``` `
manueller Export
` ``` sudo docker exec paperless-webserver-1 document_exporter ../export ``` `
Archiv erzeugen
` ``` tar -czf paper_export.tgz ./paperless_export ``` `
manueller Import
` ``` sudo docker exec paperless-webserver-1 document_importer ../export ``` `
Quelle: [https://www.youtube.com/watch?v=F-NtIbxF6oc](https://www.youtube.com/watch?v=F-NtIbxF6oc)
# Backup NAS in Amazon Cloud
[https://s3.console.aws.amazon.com/s3/buckets/paperbackup?region=eu-west-1&tab=objects](https://s3.console.aws.amazon.com/s3/buckets/paperbackup?region=eu-west-1&tab=objects)
Amazon Portal S3 → Buckets