Paperless-ngx is a community-supported open-source document management system that transforms your physical documents into a searchable online archive so you can keep, well, less paper.
Instantiate the module with:
add-module ghcr.io/compgeniuses/paperlessngx:latest 1
The output of the command will return the instance name. Output example:
{"module_id": "paperlessngx", "image_name": "paperlessngx", "image_url": "ghcr.io/compgeniuses/paperlessngx:latest"}
Let's assume that the paperless instance is named paperlessngx1
.
Launch configure-module
, by setting the following parameters:
paperless_name
: the name given to the instance that wil also appear as the name on the dachboard
PAPERLESS_TIME_ZONE
: the timezone for the project, a config that can be modified
PAPERLESS_TIME_ZONE
: the default is America/Los_Angeles
PAPERLESS_ADMIN_USER
: define the default username and password for superadmin: set to = paperlessadmin
PAPERLESS_ADMIN_PASSWORD
: Define the Default password Set to = P@perle5$
lets_encrypt
: Set LEtsecnrypt to True or False, Default is FALSE
http2https
: set redirect to True or False, Default is True
host
: the traefik host url for the project
...
Example:
api-cli run module/paperlessngx1/configure-module --data '{"host": "paperlessngx.domain.com"}'
or if modifying another value:
api-cli run module/paperlessngx5/configure-module --data '{"host": "paperlessngx.domain.com","paperless_name": "MyPaperless NGX"}'
api-cli run module/paperlessngx1/configure-module --data '{
"host": "papperlessngx.rocky9-pve2.org",
"lets_encrypt": false,
"http2https": true,
"paperless_name": "paperless-ngx",
"PAPERLESS_ADMIN_PASSWORD": "P@perle5$",
"PAPERLESS_ADMIN_USER":"paperlessadmin",
"PAPERLESS_ADMIN_MAIL":"foo@domain.com",
"PAPERLESS_TIME_ZONE":"America/Los_Angeles",
"PAPERLESS_OCR_LANGUAGE":"eng",
"PAPERLESS_COOKIE_PREFIX":"paperlessngx"
}'
The above command will:
Additional Parameters are Described here: https://docs.paperless-ngx.com/configuration/#hosting-security WHile they have not been Implemented, if you require more parameters to be defined, kindly free to raise an issue, and define why and how that parameter should be implemented for use
Send a test HTTP request to the ns8-paperless-ngx backend service:
curl http://127.0.0.1/paperlessngx/
Some configuration settings, like the smarthost setup, are not part of the
configure-module
action input: they are discovered by looking at some
Redis keys. To ensure the module is always up-to-date with the
centralized smarthost
setup every time
kickstart starts, the command bin/discover-smarthost
runs and refreshes
the state/smarthost.env
file with fresh values from Redis.
Furthermore if smarthost setup is changed when ns8-paperless-ngx is already
running, the event handler events/smarthost-changed/10reload_services
restarts the main module service.
See also the systemd/user/paperless-server.service
file.
This setting discovery is just an example to understand how the module is expected to work: it can be rewritten or discarded completely.
To uninstall the instance:
remove-module --no-preserve paperlessngx1
Test the module using the test-module.sh
script:
./test-module.sh <NODE_ADDR> ghcr.io/nethserver/ns8-paperless-ngx:latest
The tests are made using Robot Framework
Translated with Weblate.
To setup the translation process:
Paperless can make use of Tika and Gotenberg for parsing and converting "Office" documents (such as ".doc", ".xlsx" and ".odt"). Tika and Gotenberg are also needed to allow parsing of E-Mails (.eml).