Marko Oldenburg
0e7b22122e
The kubeVersion has been updated from ">=1.22.0-0" to ">=1.28.0-0" to ensure compatibility with newer Kubernetes versions. Dependencies have also been updated: the "common" chart repository was updated from "https://bjw-s.github.io/helm-charts" to "https://bjw-s-labs.github.io/helm-charts/" and its version was bumped to 4.4.0. The "postgresql" dependency version was changed from 14.0.5 to 17.0.1, the "mariadb" version was updated from 20.1.1 to 23.0.1, and the "redis" version was upgraded from 20.7.0 to 23.0.4. These updates are necessary to take advantage of the latest features, improvements, and security patches in the respective charts while ensuring compatibility with Paperless-ngx.
Paperless-ngx
A community-supported supercharged version of paperless: scan, index and archive all your physical documents
Homepage: https://charts.gabe565.com/charts/paperless-ngx/
This chart is not maintained by the upstream project and any issues with the chart should be raised here
Source Code
Requirements
Kubernetes: >=1.22.0-0
Dependencies
| Repository | Name | Version |
|---|---|---|
| https://bjw-s.github.io/helm-charts | common | 1.5.1 |
| https://charts.bitnami.com/bitnami | mariadb | 20.1.1 |
| https://charts.bitnami.com/bitnami | postgresql | 14.0.5 |
| https://charts.bitnami.com/bitnami | redis | 20.7.0 |
Installing the Chart
To install the chart with the release name paperless-ngx
OCI (Recommended)
helm install paperless-ngx oci://ghcr.io/gabe565/charts/paperless-ngx
Traditional
helm repo add gabe565 https://charts.gabe565.com
helm repo update
helm install paperless-ngx gabe565/paperless-ngx
Uninstalling the Chart
To uninstall the paperless-ngx deployment
helm uninstall paperless-ngx
The command removes all the Kubernetes components associated with the chart including persistent volumes and deletes the release.
Configuration
Read through the values.yaml file. It has several commented out suggested values. Other values may be used from the values.yaml from the bjw-s common library.
Specify each parameter using the --set key=value[,key=value] argument to helm install.
helm install paperless-ngx \
--set env.TZ="America/New York" \
gabe565/paperless-ngx
Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart.
helm install paperless-ngx gabe565/paperless-ngx -f values.yaml
Custom configuration
Database Installation
Paperless-ngx supports PostgreSQL and MariaDB.
This chart can install PostgreSQL or MariaDB and configure Paperless-ngx automatically.
See each database section in values.yaml for configuration examples.
Values
Important: When deploying an application Helm chart you can add more values from the bjw-s common library chart here
| Key | Type | Default | Description |
|---|---|---|---|
| env | object | See values.yaml | Environment variables [ref] |
| env.TZ | string | "UTC" |
Set the container timezone |
| image.pullPolicy | string | "IfNotPresent" |
Image pull policy |
| image.repository | string | "ghcr.io/paperless-ngx/paperless-ngx" |
Image repository |
| image.tag | string | "2.20.0" |
Image tag |
| ingress.main | object | See values.yaml | Enable and configure ingress settings for the chart under this key. |
| mariadb | object | See values.yaml | Enable and configure mariadb database subchart under this key. If enabled, the app's db envs will be set for you. [ref] |
| persistence.consume | object | See values.yaml | Configure consume volume settings for the chart under this key. |
| persistence.data | object | See values.yaml | Configure data volume settings for the chart under this key. |
| persistence.export | object | See values.yaml | Configure export volume settings for the chart under this key. |
| persistence.media | object | See values.yaml | Configure media volume settings for the chart under this key. |
| postgresql | object | See values.yaml | Enable and configure postgresql database subchart under this key. If enabled, the app's db envs will be set for you. [ref] |
| redis | object | See values.yaml | Enable and configure redis subchart under this key. If enabled, the app's Redis env will be set for you. [ref] |
| service.main | object | See values.yaml | Configures service settings for the chart. |
Autogenerated from chart metadata using helm-docs