norish release 0.15.4

added redis config

when upgrading refer to readme file

charts/donetick/Chart.yaml

@@ -2,8 +2,8 @@ apiVersion: v2
 name: donetick
 description: Donetick helm chart for Kubernetes
 type: application
-version: 1.0.1
+version: 1.0.6
-appVersion: "v0.1.38"
+appVersion: "v0.1.60"
 maintainers:
   - name: Richard Tomik
     email: no@m.com

charts/donetick/readme.md

@@ -27,12 +27,192 @@ $ helm install donetick donetick-chart/donetick
 
 > **Tip**: List all releases using `helm list`
 
+## Configuration Examples
+
+### Basic Installation with SQLite (Default)
+
+```bash
+helm install donetick donetick-chart/donetick
+```
+
+### Installation with External PostgreSQL
+
+Create a values file for PostgreSQL configuration:
+
+```yaml
+# values-postgres.yaml
+config:
+  database:
+    type: "postgres"
+    host: "postgresql.database.svc.cluster.local"
+    port: 5432
+    user: "donetick"
+    password: "your-secure-password"
+    name: "donetick"
+    migration: true
+
+  # Update JWT secret for production
+  jwt:
+    secret: "your-secure-jwt-secret-at-least-32-characters-long"
+
+  # Configure server settings
+  server:
+    cors_allow_origins:
+      - "https://your-domain.com"
+      - "http://localhost:5173"
+
+  # Enable features as needed
+  features:
+    notifications: true
+    realtime: true
+    oauth: false
+
+# Enable ingress for external access
+ingress:
+  enabled: true
+  className: "nginx"
+  annotations:
+    cert-manager.io/cluster-issuer: "letsencrypt-prod"
+  hosts:
+    - host: donetick.your-domain.com
+      paths:
+        - path: /
+          pathType: Prefix
+  tls:
+    - secretName: donetick-tls
+      hosts:
+        - donetick.your-domain.com
+
+# Configure persistence
+persistence:
+  enabled: true
+  storageClass: "fast-ssd"
+  size: "5Gi"
+```
+
+Install with PostgreSQL configuration:
+
+```bash
+helm install donetick donetick-chart/donetick -f values-postgres.yaml
+```
+
+### Production Installation with External Secrets
+
+For production deployments, use Kubernetes secrets for sensitive data:
+
+```yaml
+# values-production.yaml
+config:
+  database:
+    type: "postgres"
+    host: "postgresql.database.svc.cluster.local"
+    port: 5432
+    name: "donetick"
+
+  # Use existing secret for postgres credentials
+  database:
+    type: "postgres"
+    host: "postgresql.database.svc.cluster.local"
+    port: 5432
+    name: "donetick"
+    secrets:
+      existingSecret: "donetick-postgres-secret"
+      userKey: "username"
+      passwordKey: "password"
+
+  # Use existing secret for JWT
+  jwt:
+    existingSecret: "donetick-jwt-secret"
+    secretKey: "jwt-secret"
+    session_time: "168h"
+    max_refresh: "168h"
+
+  # OAuth2 configuration with secrets
+  oauth2:
+    existingSecret: "donetick-oauth-secret"
+    clientIdKey: "client-id"
+    clientSecretKey: "client-secret"
+    auth_url: "https://your-oauth-provider.com/auth"
+    token_url: "https://your-oauth-provider.com/token"
+    user_info_url: "https://your-oauth-provider.com/userinfo"
+    redirect_url: "https://donetick.your-domain.com/auth/callback"
+
+  # Production server settings
+  server:
+    cors_allow_origins:
+      - "https://donetick.your-domain.com"
+    rate_limit: 100
+    rate_period: "60s"
+
+  # Enable production features
+  features:
+    notifications: true
+    realtime: true
+    oauth: true
+
+# Security context for production
+podSecurityContext:
+  runAsNonRoot: true
+  runAsUser: 1000
+  fsGroup: 1000
+
+# Resource limits for production
+resources:
+  limits:
+    cpu: 500m
+    memory: 512Mi
+  requests:
+    cpu: 100m
+    memory: 128Mi
+
+# Ingress with TLS
+ingress:
+  enabled: true
+  className: "nginx"
+  annotations:
+    nginx.ingress.kubernetes.io/ssl-redirect: "true"
+    cert-manager.io/cluster-issuer: "letsencrypt-prod"
+  hosts:
+    - host: donetick.your-domain.com
+      paths:
+        - path: /
+          pathType: Prefix
+  tls:
+    - secretName: donetick-tls
+      hosts:
+        - donetick.your-domain.com
+```
+
+Create the required secrets:
+
+```bash
+# Postgres secret
+kubectl create secret generic donetick-postgres-secret \
+  --from-literal=username='donetick' \
+  --from-literal=password='your-secure-db-password'
+
+# JWT secret
+kubectl create secret generic donetick-jwt-secret \
+  --from-literal=jwt-secret='your-very-secure-jwt-secret-at-least-32-characters-long'
+
+# OAuth secret (if using OAuth)
+kubectl create secret generic donetick-oauth-secret \
+  --from-literal=client-id='your-oauth-client-id' \
+  --from-literal=client-secret='your-oauth-client-secret'
+```
+
+Install with production configuration:
+
+```bash
+helm install donetick donetick-chart/donetick -f values-production.yaml
+```
+
 ## Uninstalling the Chart
 
 To uninstall/delete the `donetick` deployment:
 
 ```bash
-$  helm uninstall donetick
+helm uninstall donetick
 ```
 
 ## Parameters
@@ -49,7 +229,7 @@ $  helm uninstall donetick
 | Name                    | Description                                                                          | Value              |
 |-------------------------|--------------------------------------------------------------------------------------|--------------------|
 | `image.repository`      | Donetick image repository                                                           | `donetick/donetick` |
-| `image.tag`             | Donetick image tag                                                                  | `latest`          |
+| `image.tag`             | Donetick image tag                                                                  | `v0.1.60`          |
 | `image.pullPolicy`      | Donetick image pull policy                                                          | `IfNotPresent`     |
 | `imagePullSecrets`      | Global Docker registry secret names as an array                                      | `[]`               |
 
@@ -62,12 +242,9 @@ $  helm uninstall donetick
 | `config.oauth2.existingSecret`         | Name of existing secret for OAuth2 credentials                    | `""`                |
 | `config.oauth2.clientIdKey`            | Key in the existing secret for OAuth2 client ID                   | `"client-id"`       |
 | `config.oauth2.clientSecretKey`        | Key in the existing secret for OAuth2 client secret               | `"client-secret"`   |
-| `config.database.existingSecret`       | Name of existing secret for database credentials                  | `""`                |
+| `config.database.secrets.existingSecret` | Name of existing secret for postgres credentials                | `""`                |
-| `config.database.hostKey`              | Key in the existing secret for database host                      | `"db-host"`         |
+| `config.database.secrets.userKey`        | Key in the existing secret for postgres username                | `"username"`        |
-| `config.database.portKey`              | Key in the existing secret for database port                      | `"db-port"`         |
+| `config.database.secrets.passwordKey`    | Key in the existing secret for postgres password                | `"password"`        |
-| `config.database.userKey`              | Key in the existing secret for database user                      | `"db-user"`         |
-| `config.database.passwordKey`          | Key in the existing secret for database password                  | `"db-password"`     |
-| `config.database.nameKey`              | Key in the existing secret for database name                      | `"db-name"`         |
 
 ### Deployment parameters
 
@@ -90,7 +267,12 @@ $  helm uninstall donetick
 | `service.type`             | Kubernetes Service type                              | `ClusterIP` |
 | `service.port`             | Service HTTP port                                    | `2021`      |
 | `service.annotations`      | Additional annotations for Service                   | `{}`        |
-| `service.nodePort`         | Service HTTP node port (when applicable)             | `""`        |
+
+### Pod Configuration
+
+| Name                       | Description                                          | Value       |
+|----------------------------|------------------------------------------------------|-------------|
+| `podAnnotations`           | Additional annotations for pods                      | `{}`        |
 
 ### Ingress parameters
 
@@ -108,7 +290,174 @@ $  helm uninstall donetick
 
 | Name                          | Description                                          | Value         |
 |-------------------------------|------------------------------------------------------|---------------|
-| `persistence.enabled`         | Enable persistence using PVC                         | `true`        |
+| `persistence.enabled`         | Enable persistence using PVC                         | `false`         |
-| `persistence.storageClass`    | PVC Storage Class                                    | `"longhorn"`  |
+| `persistence.storageClass`    | PVC Storage Class                                    | `""`            |
 | `persistence.accessMode`      | PVC Access Mode                                      | `ReadWriteOnce` |
-| `persistence.size`            |
+| `persistence.size`            | PVC Size                                             | `1Gi`           |
+
+### Health Checks
+
+| Name                                    | Description                                          | Value         |
+|----------------------------------------|------------------------------------------------------|---------------|
+| `probes.startup.enabled`               | Enable startup probe                                 | `true`        |
+| `probes.startup.initialDelaySeconds`   | Initial delay for startup probe                      | `10`          |
+| `probes.startup.periodSeconds`         | Period for startup probe                             | `10`          |
+| `probes.startup.failureThreshold`      | Failure threshold for startup probe                  | `30`          |
+| `probes.liveness.enabled`              | Enable liveness probe                                | `true`        |
+| `probes.liveness.initialDelaySeconds`  | Initial delay for liveness probe                     | `30`          |
+| `probes.liveness.periodSeconds`        | Period for liveness probe                            | `10`          |
+| `probes.readiness.enabled`             | Enable readiness probe                               | `true`        |
+| `probes.readiness.initialDelaySeconds` | Initial delay for readiness probe                    | `5`           |
+| `probes.readiness.periodSeconds`       | Period for readiness probe                           | `5`           |
+
+### Application Configuration
+
+| Name                                    | Description                                          | Value         |
+|----------------------------------------|------------------------------------------------------|---------------|
+| `config.name`                          | Application name                                     | `selfhosted`  |
+| `config.is_done_tick_dot_com`          | Enable donetick.com features                         | `false`       |
+| `config.is_user_creation_disabled`     | Disable user registration                            | `false`       |
+
+### Real-time Configuration
+
+| Name                                    | Description                                          | Value         |
+|----------------------------------------|------------------------------------------------------|---------------|
+| `config.realtime.max_connections`      | Maximum WebSocket connections                        | `100`         |
+| `config.realtime.ping_interval`        | WebSocket ping interval                              | `30s`         |
+| `config.realtime.pong_wait`            | WebSocket pong wait timeout                          | `60s`         |
+| `config.realtime.write_wait`           | WebSocket write timeout                              | `10s`         |
+| `config.realtime.max_message_size`     | Maximum WebSocket message size                       | `512`         |
+
+### Database Configuration
+
+| Name                                    | Description                                          | Value         |
+|----------------------------------------|------------------------------------------------------|---------------|
+| `config.database.type`                 | Database type (sqlite or postgres)                   | `sqlite`      |
+| `config.database.migration`            | Enable database migrations                           | `true`        |
+| `config.database.host`                 | PostgreSQL host (when type=postgres)                 | `""`          |
+| `config.database.port`                 | PostgreSQL port (when type=postgres)                 | `5432`        |
+| `config.database.user`                 | PostgreSQL user (when type=postgres)                 | `""`          |
+| `config.database.password`             | PostgreSQL password (when type=postgres)             | `""`          |
+| `config.database.name`                 | PostgreSQL database name (when type=postgres)        | `""`          |
+
+### JWT Configuration
+
+| Name                                    | Description                                          | Value         |
+|----------------------------------------|------------------------------------------------------|---------------|
+| `config.jwt.secret`                    | JWT signing secret                                   | `changeme-this-secret-should-be-at-least-32-characters-long` |
+| `config.jwt.session_time`              | JWT session duration                                 | `168h`        |
+| `config.jwt.max_refresh`               | JWT maximum refresh duration                         | `168h`        |
+
+### Server Configuration
+
+| Name                                    | Description                                          | Value         |
+|----------------------------------------|------------------------------------------------------|---------------|
+| `config.server.port`                   | Server port                                          | `2021`        |
+| `config.server.read_timeout`           | Server read timeout                                  | `10s`         |
+| `config.server.write_timeout`          | Server write timeout                                 | `10s`         |
+| `config.server.rate_period`            | Rate limiting period                                 | `60s`         |
+| `config.server.rate_limit`             | Rate limiting requests per period                    | `300`         |
+| `config.server.serve_frontend`         | Serve frontend files                                 | `true`        |
+
+### Feature Flags
+
+| Name                                    | Description                                          | Value         |
+|----------------------------------------|------------------------------------------------------|---------------|
+| `config.features.notifications`        | Enable notifications                                 | `true`        |
+| `config.features.realtime`             | Enable real-time features                           | `true`        |
+| `config.features.oauth`                | Enable OAuth authentication                         | `false`       |
+
+## Database Setup
+
+### PostgreSQL Requirements
+
+When using PostgreSQL, ensure you have:
+
+1. **Database Created**: Create a database for Donetick
+```sql
+CREATE DATABASE donetick;
+CREATE USER donetick WITH PASSWORD 'your-secure-password';
+GRANT ALL PRIVILEGES ON DATABASE donetick TO donetick;
+```
+
+2. **Network Access**: Ensure Donetick can reach your PostgreSQL instance
+3. **Proper Credentials**: Configure database credentials in values or secrets
+
+### Database Migration
+
+Donetick automatically runs database migrations on startup when `config.database.migration: true`. For production:
+
+1. **Review Migrations**: Check what migrations will be applied
+2. **Backup Database**: Always backup before running migrations
+3. **Monitor Startup**: Watch pod logs during initial deployment
+
+## Troubleshooting
+
+### Common Issues
+
+#### 1. Real-time Configuration Panic
+**Error**: `Invalid real-time configuration: maxConnections must be positive, got 0`
+
+**Solution**: Ensure the real-time configuration is properly set:
+```yaml
+config:
+  realtime:
+    max_connections: 100  # Must be > 0
+```
+
+#### 2. Database Connection Issues
+**Error**: Database connection failures
+
+**Solutions**:
+- Verify PostgreSQL is running and accessible
+- Check database credentials in secrets
+- Ensure database name exists
+- Verify network policies allow connection
+
+#### 3. JWT Secret Issues
+**Error**: JWT authentication failures
+
+**Solution**: Ensure JWT secret is at least 32 characters:
+```yaml
+config:
+  jwt:
+    secret: "your-very-secure-jwt-secret-at-least-32-characters-long"
+```
+
+#### 4. CORS Issues
+**Error**: Cross-origin request blocked
+
+**Solution**: Configure CORS origins:
+```yaml
+config:
+  server:
+    cors_allow_origins:
+      - "https://your-domain.com"
+      - "http://localhost:5173"
+```
+
+### Debugging
+
+Check application logs:
+```bash
+kubectl logs deployment/donetick -f
+```
+
+Check configuration:
+```bash
+kubectl get configmap donetick-configmap -o yaml
+```
+
+Verify secrets:
+```bash
+kubectl get secret donetick-secrets -o yaml
+```
+
+## Contributing
+
+Please feel free to contribute by opening issues or pull requests at:
+https://github.com/rtomik/helm-charts
+
+## License
+
+This Helm chart is licensed under the MIT License.

charts/donetick/templates/configmap.yaml

@@ -22,15 +22,18 @@ data:
       {{- if .Values.config.database.migration_retry }}
       migration_retry: {{ .Values.config.database.migration_retry }}
       {{- end }}
+      migration_timeout: {{ .Values.config.database.migration_timeout | default "300s" | quote }}
       {{- if eq .Values.config.database.type "postgres" }}
-      {{- if not .Values.config.database.existingSecret }}
       host: {{ .Values.config.database.host | quote }}
       port: {{ .Values.config.database.port }}
+      name: {{ .Values.config.database.name | quote }}
+      {{- if not .Values.config.database.secrets.existingSecret }}
       user: {{ .Values.config.database.user | quote }}
       password: {{ .Values.config.database.password | quote }}
-      name: {{ .Values.config.database.name | quote }}
       {{- else }}
-      # Database credentials will be injected via environment variables from Secret
+      # Reference environment variables for database credentials
+      user: "$DT_DATABASE_USER"
+      password: "$DT_DATABASE_PASSWORD"
       {{- end }}
       {{- end }}
     jwt:
@@ -74,4 +77,20 @@ data:
       token_url: {{ .Values.config.oauth2.token_url | default "" | quote }}
       user_info_url: {{ .Values.config.oauth2.user_info_url | default "" | quote }}
       redirect_url: {{ .Values.config.oauth2.redirect_url | default "" | quote }}
-      name: {{ .Values.config.oauth2.name | default "" | quote }}
+      name: {{ .Values.config.oauth2.name | default "" | quote }}
+    realtime:
+      max_connections: {{ .Values.config.realtime.max_connections }}
+      ping_interval: {{ .Values.config.realtime.ping_interval | quote }}
+      pong_wait: {{ .Values.config.realtime.pong_wait | quote }}
+      write_wait: {{ .Values.config.realtime.write_wait | quote }}
+      max_message_size: {{ .Values.config.realtime.max_message_size }}
+    logging:
+      level: {{ .Values.config.logging.level | quote }}
+      format: {{ .Values.config.logging.format | quote }}
+    storage:
+      type: {{ .Values.config.storage.type | quote }}
+      path: {{ .Values.config.storage.path | quote }}
+    features:
+      notifications: {{ .Values.config.features.notifications }}
+      realtime: {{ .Values.config.features.realtime }}
+      oauth: {{ .Values.config.features.oauth }}

charts/donetick/templates/deployment.yaml

@@ -50,6 +50,17 @@ spec:
             - name: http
               containerPort: {{ .Values.config.server.port }}
               protocol: TCP
+          {{- if .Values.probes.startup.enabled }}
+          startupProbe:
+            httpGet:
+              path: {{ .Values.probes.startup.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.startup.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.startup.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.startup.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.startup.failureThreshold }}
+            successThreshold: {{ .Values.probes.startup.successThreshold }}
+          {{- end }}
           {{- if .Values.probes.liveness.enabled }}
           livenessProbe:
             httpGet:
@@ -77,15 +88,44 @@ spec:
             - name: {{ .name }}
               value: {{ .value | quote }}
           {{- end }}
-          {{- if or .Values.config.jwt.existingSecret .Values.config.oauth2.existingSecret .Values.config.database.existingSecret }}
+            # Database configuration environment variables
-            # Secret-based environment variables
+            {{- if eq .Values.config.database.type "postgres" }}
+            - name: DT_DATABASE_TYPE
+              value: "postgres"
+            - name: DT_DATABASE_HOST
+              value: {{ .Values.config.database.host | quote }}
+            - name: DT_DATABASE_PORT
+              value: {{ .Values.config.database.port | quote }}
+            - name: DT_DATABASE_NAME
+              value: {{ .Values.config.database.name | quote }}
+            {{- if .Values.config.database.secrets.existingSecret }}
+            - name: DT_DATABASE_USER
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.config.database.secrets.existingSecret }}
+                  key: {{ .Values.config.database.secrets.userKey }}
+            - name: DT_DATABASE_PASSWORD
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.config.database.secrets.existingSecret }}
+                  key: {{ .Values.config.database.secrets.passwordKey }}
+            {{- end }}
+            {{- else }}
+            - name: DT_DATABASE_TYPE
+              value: {{ .Values.config.database.type | quote }}
+            {{- end }}
+            # JWT configuration
             {{- if .Values.config.jwt.existingSecret }}
             - name: DT_JWT_SECRET
               valueFrom:
                 secretKeyRef:
                   name: {{ .Values.config.jwt.existingSecret }}
                   key: {{ .Values.config.jwt.secretKey }}
+            {{- else }}
+            - name: DT_JWT_SECRET
+              value: {{ .Values.config.jwt.secret | quote }}
             {{- end }}
+            # OAuth2 configuration
             {{- if .Values.config.oauth2.existingSecret }}
             - name: DT_OAUTH2_CLIENT_ID
               valueFrom:
@@ -98,34 +138,6 @@ spec:
                   name: {{ .Values.config.oauth2.existingSecret }}
                   key: {{ .Values.config.oauth2.clientSecretKey }}
             {{- end }}
-            {{- if and .Values.config.database.existingSecret (eq .Values.config.database.type "postgres") }}
-            - name: DT_DB_HOST
-              valueFrom:
-                secretKeyRef:
-                  name: {{ .Values.config.database.existingSecret }}
-                  key: {{ .Values.config.database.hostKey }}
-            - name: DT_DB_PORT
-              valueFrom:
-                secretKeyRef:
-                  name: {{ .Values.config.database.existingSecret }}
-                  key: {{ .Values.config.database.portKey }}
-            - name: DT_DB_USER
-              valueFrom:
-                secretKeyRef:
-                  name: {{ .Values.config.database.existingSecret }}
-                  key: {{ .Values.config.database.userKey }}
-            - name: DT_DB_PASSWORD
-              valueFrom:
-                secretKeyRef:
-                  name: {{ .Values.config.database.existingSecret }}
-                  key: {{ .Values.config.database.passwordKey }}
-            - name: DT_DB_NAME
-              valueFrom:
-                secretKeyRef:
-                  name: {{ .Values.config.database.existingSecret }}
-                  key: {{ .Values.config.database.nameKey }}
-            {{- end }}
-          {{- end }}
           {{- with .Values.extraEnv }}
             {{- toYaml . | nindent 12 }}
           {{- end }}
@@ -148,9 +160,14 @@ spec:
         - name: config
           configMap:
             name: {{ include "donetick.fullname" . }}-configmap
+        {{- if .Values.persistence.enabled }}
         - name: data
           persistentVolumeClaim:
             claimName: {{ include "donetick.fullname" . }}-data
+        {{- else }}
+        - name: data
+          emptyDir: {}
+        {{- end }}
         {{- if not .Values.containerSecurityContext.readOnlyRootFilesystem }}
         - name: tmp
           emptyDir: {}

charts/donetick/templates/secret.yaml

@@ -1,4 +1,4 @@
-{{- if or (not .Values.config.jwt.existingSecret) (and (not .Values.config.oauth2.existingSecret) (or .Values.config.oauth2.client_id .Values.config.oauth2.client_secret)) (and (eq .Values.config.database.type "postgres") (not .Values.config.database.existingSecret)) }}
+{{- if or (not .Values.config.jwt.existingSecret) (and (not .Values.config.oauth2.existingSecret) (or .Values.config.oauth2.client_id .Values.config.oauth2.client_secret)) (and (eq .Values.config.database.type "postgres") (not .Values.config.database.secrets.existingSecret)) }}
 apiVersion: v1
 kind: Secret
 metadata:
@@ -10,8 +10,8 @@ data:
   {{- if not .Values.config.jwt.existingSecret }}
   {{ .Values.config.jwt.secretKey }}: {{ .Values.config.jwt.secret | b64enc }}
   {{- end }}
-  {{- if and (eq .Values.config.database.type "postgres") (not .Values.config.database.existingSecret) }}
+  {{- if and (eq .Values.config.database.type "postgres") (not .Values.config.database.secrets.existingSecret) }}
-  {{ .Values.config.database.passwordKey }}: {{ .Values.config.database.password | b64enc }}
+  {{ .Values.config.database.secrets.passwordKey }}: {{ .Values.config.database.password | b64enc }}
   {{- end }}
   {{- if and (not .Values.config.oauth2.existingSecret) .Values.config.oauth2.client_id }}
   {{ .Values.config.oauth2.clientIdKey }}: {{ .Values.config.oauth2.client_id | b64enc }}

charts/donetick/templates/service.yaml

@@ -4,6 +4,10 @@ metadata:
   name: {{ include "donetick.fullname" . }}
   labels:
     {{- include "donetick.labels" . | nindent 4 }}
+  {{- with .Values.service.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
 spec:
   type: {{ .Values.service.type }}
   ports:

charts/donetick/values.yaml

@@ -5,8 +5,10 @@ fullnameOverride: ""
 ## Image settings
 image:
   repository: donetick/donetick
-  tag: "v0.1.38"
+  tag: "v0.1.60"
   pullPolicy: IfNotPresent
+
+imagePullSecrets: []
   
 ## Deployment settings
 replicaCount: 1
@@ -34,10 +36,14 @@ nodeSelector: {}
 tolerations: []
 affinity: {}
 
+## Pod annotations
+podAnnotations: {}
+
 ## Service settings
 service:
   type: ClusterIP
   port: 2021
+  annotations: {}
 
 ## Ingress settings
 ingress:
@@ -85,16 +91,28 @@ extraVolumeMounts: []
 extraVolumes: []
 
 ## Resource limits and requests
-# resources:
+resources: {}
-#   limits:
+  # We usually recommend not to specify default resources and to leave this as a conscious
-#     cpu: 500m
+  # choice for the user. This also increases chances charts run on environments with little
-#     memory: 512Mi
+  # resources, such as Minikube. If you do want to specify resources, uncomment the following
-#   requests:
+  # lines, adjust them as necessary, and remove the curly braces after 'resources:'.
-#     cpu: 100m
+  # limits:
-#     memory: 128Mi
+  #   cpu: 500m
+  #   memory: 512Mi
+  # requests:
+  #   cpu: 100m
+  #   memory: 128Mi
 
 ## Application health checks
 probes:
+  startup:
+    enabled: true
+    initialDelaySeconds: 30
+    periodSeconds: 15
+    timeoutSeconds: 15
+    failureThreshold: 80
+    successThreshold: 1
+    path: /health
   liveness:
     enabled: true
     initialDelaySeconds: 30
@@ -139,21 +157,18 @@ config:
     # Migration options
     migration_skip: false  # Set to true to skip database migrations
     migration_retry: 3     # Number of retries for failed migrations
-    
+    migration_timeout: "600s"  # Timeout for database migrations (default: 10 minutes)
-    # These are only required for postgres - direct configuration
+
+    # These are only required for postgres
     host: ""
     port: 5432
-    user: ""
-    password: ""
     name: ""
-    
+
-    # Secret configuration for database credentials
+    # Secret configuration for postgres credentials
-    existingSecret: ""        # Name of existing Kubernetes secret
+    secrets:
-    hostKey: "db-host"        # Key in the secret for database host
+      existingSecret: ""        # Name of existing Kubernetes secret containing postgres credentials
-    portKey: "db-port"        # Key in the secret for database port
+      userKey: "username"       # Key in the secret for database username
-    userKey: "db-user"        # Key in the secret for database user
+      passwordKey: "password"   # Key in the secret for database password
-    passwordKey: "db-password" # Key in the secret for database password
-    nameKey: "db-name"        # Key in the secret for database name
   
   # Security settings
   # For production, use a generated secret and store in a Kubernetes Secret
@@ -207,4 +222,28 @@ config:
     token_url: ""
     user_info_url: ""
     redirect_url: ""
-    name: ""
+    name: ""
+
+  # Real-time configuration
+  realtime:
+    max_connections: 100
+    ping_interval: "30s"
+    pong_wait: "60s"
+    write_wait: "10s"
+    max_message_size: 512
+
+  # Logging configuration
+  logging:
+    level: "info"
+    format: "json"
+
+  # Storage configuration
+  storage:
+    type: "local"
+    path: "/donetick-data/uploads"
+
+  # Feature flags
+  features:
+    notifications: true
+    realtime: true
+    oauth: false

charts/mealie/Chart.yaml

@@ -2,8 +2,8 @@ apiVersion: v2
 name: mealie
 description: Mealie helm chart for Kubernetes - Recipe management and meal planning
 type: application
-version: 0.0.1
+version: 0.0.2
-appVersion: "v3.1.1"
+appVersion: "v3.2.1"
 maintainers:
   - name: Richard Tomik
     email: no@m.com

charts/mealie/templates/pvc.yaml

@@ -18,4 +18,10 @@ spec:
   resources:
     requests:
       storage: {{ .Values.persistence.size | quote }}
-{{- end }}
+  {{- if .Values.persistence.selector }}
+  {{- with .Values.persistence.selector }}
+  selector:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+  {{- end }}
+{{- end }}

charts/mealie/values.yaml

@@ -5,7 +5,7 @@ fullnameOverride: ""
 ## Image settings
 image:
   repository: ghcr.io/mealie-recipes/mealie
-  tag: "v3.1.1"
+  tag: "v3.2.1"
   pullPolicy: IfNotPresent
   
 ## Deployment settings

charts/norish/Chart.yaml

@@ -0,0 +1,17 @@
+apiVersion: v2
+name: norish
+description: Norish helm chart for Kubernetes - A recipe management and meal planning application
+type: application
+version: 0.0.5
+appVersion: "v0.15.4-beta"
+maintainers:
+  - name: Richard Tomik
+    email: no@m.com
+keywords:
+  - recipe
+  - meal-planning
+  - food
+  - norish
+home: https://github.com/rtomik/helm-charts
+sources:
+  - https://github.com/norishapp/norish

charts/norish/readme.md

@@ -0,0 +1,663 @@
+cl# Norish Helm Chart
+
+A Helm chart for deploying [Norish](https://github.com/norishapp/norish), a recipe management and meal planning application, on Kubernetes.
+
+## Introduction
+
+This chart bootstraps a Norish deployment on a Kubernetes cluster using the Helm package manager.
+
+**IMPORTANT: This chart requires a central PostgreSQL database and Redis server.** You must have both a PostgreSQL and Redis server available before deploying this chart. The chart does not include PostgreSQL or Redis deployments.
+
+**Note:** This chart includes a Chrome headless sidecar container that is required for recipe parsing and scraping functionality. Chrome requires elevated security privileges (`SYS_ADMIN` capability) and additional resources (recommend 256Mi-512Mi memory).
+
+## Prerequisites
+
+- Kubernetes 1.19+
+- Helm 3.0+
+- **PostgreSQL database server** (required)
+- **Redis server** (required for v0.14.0+)
+- PV provisioner support in the underlying infrastructure (if persistence is enabled)
+
+## Installing the Chart
+
+To install the chart with the release name `norish`:
+
+```bash
+$ helm repo add helm-charts https://rtomik.github.io/helm-charts
+$ helm install norish helm-charts/norish
+```
+
+The command deploys Norish on the Kubernetes cluster with default configuration. The [Parameters](#parameters) section lists the parameters that can be configured during installation.
+
+## Uninstalling the Chart
+
+To uninstall/delete the `norish` deployment:
+
+```bash
+helm uninstall norish
+```
+
+This command removes all the Kubernetes components associated with the chart and deletes the release.
+
+## Configuration
+
+### Required Configuration
+
+Before deploying, you must configure:
+
+1. **PostgreSQL Database** (REQUIRED): A central PostgreSQL database must be available
+   - Configure `database.host` to point to your PostgreSQL server
+   - Ensure the database exists before deployment
+   - Set appropriate credentials
+
+2. **Redis Server** (REQUIRED for v0.14.0+): A Redis server must be available
+   - Configure `redis.host` to point to your Redis server
+   - Configure authentication if required
+   - Used for background job processing and queues
+
+3. **Master Key**: A 32-byte base64-encoded encryption key
+   ```bash
+   # Generate a master key
+   openssl rand -base64 32
+   ```
+
+4. **Application URL**: Set `config.authUrl` to match your ingress hostname
+
+### Authentication Configuration
+
+**Authentication providers are now optional!** You can deploy Norish in two ways:
+
+**Option 1: Password Authentication (Simple Setup)**
+- No external authentication provider required
+- Users can register and log in with email/password
+- Perfect for self-hosted, single-tenant deployments
+- Enabled automatically when no OAuth/OIDC provider is configured
+
+**Option 2: OAuth/OIDC Provider (Enterprise Setup)**
+- Configure ONE of the following:
+  - OIDC/OAuth2
+  - GitHub OAuth
+  - Google OAuth
+- Recommended for multi-user environments
+- Can be combined with password authentication via `config.passwordAuthEnabled`
+
+### Example: Minimal Installation (Password Authentication)
+
+This is the simplest setup using built-in password authentication:
+
+```yaml
+# values.yaml
+database:
+  host: "postgresql.default.svc.cluster.local"
+  port: 5432
+  name: norish
+  username: norish
+  password: "secure-password"
+
+redis:
+  host: "redis.default.svc.cluster.local"
+  port: 6379
+  database: 0
+  # Leave password empty if Redis has no authentication
+
+config:
+  authUrl: "https://norish.example.com"
+  masterKey:
+    value: "<your-32-byte-base64-key>"
+  # passwordAuthEnabled defaults to true when no OAuth/OIDC is configured
+
+ingress:
+  enabled: true
+  hosts:
+    - host: norish.example.com
+      paths:
+        - path: /
+          pathType: Prefix
+  tls:
+    - hosts:
+        - norish.example.com
+```
+
+Install with:
+```bash
+$ helm repo add helm-charts https://rtomik.github.io/helm-charts
+$ helm install norish helm-charts/norish -f values.yaml
+```
+
+### Example: Installation with OIDC
+
+For enterprise deployments with an external identity provider:
+
+```yaml
+# values.yaml
+database:
+  host: "postgresql.default.svc.cluster.local"
+  port: 5432
+  name: norish
+  username: norish
+  password: "secure-password"
+
+config:
+  authUrl: "https://norish.example.com"
+  masterKey:
+    value: "<your-32-byte-base64-key>"
+  # Optional: Allow both OIDC and password authentication
+  passwordAuthEnabled: "true"
+  auth:
+    oidc:
+      enabled: true
+      name: "MyAuth"
+      issuer: "https://auth.example.com"
+      clientId: "<your-client-id>"
+      clientSecret: "<your-client-secret>"
+
+ingress:
+  enabled: true
+  hosts:
+    - host: norish.example.com
+      paths:
+        - path: /
+          pathType: Prefix
+  tls:
+    - hosts:
+        - norish.example.com
+```
+
+Install with:
+```bash
+$ helm repo add helm-charts https://rtomik.github.io/helm-charts
+$ helm install norish helm-charts/norish -f values.yaml
+```
+
+### Example: Using Existing Secrets
+
+For production deployments, store sensitive data in Kubernetes secrets:
+
+```yaml
+# values.yaml
+database:
+  host: "postgresql.default.svc.cluster.local"
+  existingSecret: "norish-db-secret"
+  usernameKey: "username"
+  passwordKey: "password"
+
+config:
+  masterKey:
+    existingSecret: "norish-master-key"
+    secretKey: "master-key"
+  auth:
+    oidc:
+      enabled: true
+      name: "MyAuth"
+      issuer: "https://auth.example.com"
+      existingSecret: "norish-oidc-secret"
+      clientIdKey: "client-id"
+      clientSecretKey: "client-secret"
+```
+
+Create the secrets:
+```bash
+# Database credentials
+kubectl create secret generic norish-db-secret \
+  --from-literal=username="norish" \
+  --from-literal=password="secure-db-password"
+
+# Master encryption key
+kubectl create secret generic norish-master-key \
+  --from-literal=master-key="$(openssl rand -base64 32)"
+
+# OIDC credentials
+kubectl create secret generic norish-oidc-secret \
+  --from-literal=client-id="<your-client-id>" \
+  --from-literal=client-secret="<your-client-secret>"
+```
+
+### Example: Using Existing PVC
+
+If you want to use an existing PersistentVolumeClaim for uploads storage:
+
+```yaml
+# values.yaml
+persistence:
+  enabled: true
+  existingClaim: "my-existing-pvc"
+```
+
+This is useful when:
+- You want to reuse storage from a previous installation
+- You have pre-provisioned PVCs with specific configurations
+- You're managing PVCs separately from the Helm chart
+
+### Optional Configuration
+
+Version v0.13.6-beta introduces additional optional configuration options:
+
+```yaml
+config:
+  # Log level configuration
+  logLevel: "info"  # Options: trace, debug, info, warn, error, fatal
+
+  # Additional trusted origins (useful when behind a proxy or using multiple domains)
+  trustedOrigins: "http://192.168.1.100:3000,https://norish.example.com"
+
+  # Enable/disable password authentication
+  # Defaults to true when no OAuth/OIDC is configured, false otherwise
+  # Set to "true" to enable password auth alongside OAuth/OIDC
+  passwordAuthEnabled: "true"
+
+  auth:
+    oidc:
+      enabled: true
+      name: "MyAuth"
+      issuer: "https://auth.example.com"
+      # Optional: Custom well-known configuration URL
+      # By default derived from issuer
+      wellKnown: "https://auth.example.com/.well-known/openid-configuration"
+      clientId: "<your-client-id>"
+      clientSecret: "<your-client-secret>"
+```
+
+### Customizing Chrome Headless Resources
+
+Chrome headless is required but you can customize its resource limits:
+
+```yaml
+chrome:
+  enabled: true  # Must be true for v0.13.6+
+  resources:
+    limits:
+      cpu: 500m
+      memory: 512Mi
+    requests:
+      cpu: 100m
+      memory: 256Mi
+```
+
+### Setting Up PostgreSQL Database
+
+You need to create the database before deploying this chart:
+
+```sql
+-- Connect to your PostgreSQL server
+CREATE DATABASE norish;
+CREATE USER norish WITH ENCRYPTED PASSWORD 'secure-password';
+GRANT ALL PRIVILEGES ON DATABASE norish TO norish;
+```
+
+Or if using a centralized PostgreSQL Helm chart or service, ensure the database is created and accessible from your Kubernetes cluster.
+
+## Parameters
+
+### Global Parameters
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `nameOverride` | Override the chart name | `""` |
+| `fullnameOverride` | Override the full resource names | `""` |
+
+### Image Parameters
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `image.repository` | Norish image repository | `norishapp/norish` |
+| `image.tag` | Norish image tag | `v0.15.4-beta` |
+| `image.pullPolicy` | Image pull policy | `IfNotPresent` |
+| `imagePullSecrets` | Image pull secrets | `[]` |
+
+### Deployment Parameters
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `replicaCount` | Number of replicas | `1` |
+| `revisionHistoryLimit` | Number of old ReplicaSets to retain | `3` |
+
+### Service Parameters
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `service.type` | Kubernetes service type | `ClusterIP` |
+| `service.port` | Service port | `3000` |
+| `service.annotations` | Service annotations | `{}` |
+
+### Ingress Parameters
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `ingress.enabled` | Enable ingress | `false` |
+| `ingress.className` | Ingress class name | `""` |
+| `ingress.annotations` | Ingress annotations | `{"traefik.ingress.kubernetes.io/router.entrypoints": "websecure"}` |
+| `ingress.hosts` | Ingress hosts configuration | See values.yaml |
+| `ingress.tls` | Ingress TLS configuration | See values.yaml |
+
+### Persistence Parameters
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `persistence.enabled` | Enable persistent storage | `true` |
+| `persistence.existingClaim` | Use an existing PVC instead of creating a new one | `""` |
+| `persistence.storageClass` | Storage class name | `""` |
+| `persistence.accessMode` | Access mode | `ReadWriteOnce` |
+| `persistence.size` | Storage size | `5Gi` |
+| `persistence.annotations` | PVC annotations | `{}` |
+
+### Application Configuration
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `config.authUrl` | Application URL (required) | `"http://norish.domain.com"` |
+| `config.masterKey.value` | Master encryption key | `""` |
+| `config.masterKey.existingSecret` | Use existing secret for master key | `""` |
+| `config.logLevel` | Log level: trace, debug, info, warn, error, fatal | `""` |
+| `config.trustedOrigins` | Additional trusted origins (comma-separated) | `""` |
+| `config.passwordAuthEnabled` | Enable/disable password authentication (defaults to true when no OAuth/OIDC configured) | `""` |
+| `config.auth.oidc.enabled` | Enable OIDC authentication | `false` |
+| `config.auth.oidc.name` | OIDC provider name | `"MyAuth"` |
+| `config.auth.oidc.issuer` | OIDC issuer URL | `""` |
+| `config.auth.oidc.wellKnown` | OIDC well-known configuration URL (optional) | `""` |
+| `config.auth.oidc.clientId` | OIDC client ID | `""` |
+| `config.auth.oidc.clientSecret` | OIDC client secret | `""` |
+| `config.auth.github.enabled` | Enable GitHub OAuth | `false` |
+| `config.auth.github.clientId` | GitHub client ID | `""` |
+| `config.auth.github.clientSecret` | GitHub client secret | `""` |
+| `config.auth.google.enabled` | Enable Google OAuth | `false` |
+| `config.auth.google.clientId` | Google client ID | `""` |
+| `config.auth.google.clientSecret` | Google client secret | `""` |
+
+### Database Parameters (REQUIRED)
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `database.host` | PostgreSQL database host (required) | `""` |
+| `database.port` | PostgreSQL database port | `5432` |
+| `database.name` | PostgreSQL database name | `norish` |
+| `database.username` | PostgreSQL username | `postgres` |
+| `database.password` | PostgreSQL password | `""` |
+| `database.existingSecret` | Use existing secret for database credentials | `""` |
+| `database.usernameKey` | Key in secret for username | `"username"` |
+| `database.passwordKey` | Key in secret for password | `"password"` |
+| `database.databaseKey` | Key in secret for database name | `"database"` |
+| `database.hostKey` | Key in secret for host | `"host"` |
+
+### Redis Parameters (REQUIRED for v0.14.0+)
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `redis.host` | Redis server hostname (required) | `""` |
+| `redis.port` | Redis server port | `6379` |
+| `redis.database` | Redis database number | `0` |
+| `redis.username` | Redis username (Redis 6.0+, optional) | `""` |
+| `redis.password` | Redis password (leave empty if no auth) | `""` |
+| `redis.existingSecret` | Use existing secret for Redis URL (recommended for production) | `""` |
+| `redis.urlKey` | Key in existingSecret containing the full Redis URL | `"redis-url"` |
+| `redis.passwordKey` | Key in existingSecret for password (for compatibility) | `"password"` |
+
+### Chrome Headless Parameters (REQUIRED)
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `chrome.enabled` | Enable Chrome headless sidecar (required for v0.13.6+) | `true` |
+| `chrome.image.repository` | Chrome headless image repository | `zenika/alpine-chrome` |
+| `chrome.image.tag` | Chrome headless image tag | `latest` |
+| `chrome.image.pullPolicy` | Chrome image pull policy | `IfNotPresent` |
+| `chrome.port` | Chrome remote debugging port | `3000` |
+| `chrome.resources` | Chrome container resource limits/requests | `{}` |
+
+### Security Parameters
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `podSecurityContext.runAsNonRoot` | Run as non-root user | `true` |
+| `podSecurityContext.runAsUser` | User ID to run as | `1000` |
+| `podSecurityContext.fsGroup` | Group ID for filesystem | `1000` |
+
+### Resource Parameters
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `resources` | CPU/Memory resource requests/limits | `{}` |
+
+### Health Check Parameters
+
+| Name | Description | Default |
+|------|-------------|---------|
+| `probes.startup.enabled` | Enable startup probe | `true` |
+| `probes.liveness.enabled` | Enable liveness probe | `true` |
+| `probes.readiness.enabled` | Enable readiness probe | `true` |
+
+## What's New in v0.13.6-beta
+
+This version introduces several improvements and new features:
+
+**UI/UX Improvements:**
+- Ability to change prompts used in Settings → Admin
+- Improved transcriber logic
+- Double tapping/clicking planned recipes now opens the recipe page
+- Small icon that opens the original recipe page
+- Add recipes button now opens a dropdown instead of instantly redirecting to manual creation
+
+**New Features:**
+- Support for trusting additional origins using `TRUSTED_ORIGINS` environment variable (comma-separated)
+- Customizable password authentication via `PASSWORD_AUTH_ENABLED` flag
+- Configurable log level via `NEXT_PUBLIC_LOG_LEVEL`
+
+**Bug Fixes:**
+- User menu remaining open when clicking import
+- Text truncation no longer uses the tailwind truncate class in the calendar
+- Comma decimals being parsed as nothing (e.g., 2,5 ended up as 25)
+- Unicode character handling
+
+**Breaking Changes:**
+- Chrome headless is now mandatory for improved parsing functionality
+
+## Authentication Setup
+
+Norish v0.13.6-beta and later support multiple authentication methods:
+
+### Password Authentication (Default)
+
+When no external authentication provider is configured, Norish automatically enables password-based authentication. Users can:
+- Register new accounts with email and password
+- Log in using their credentials
+- Manage their account through the web interface
+
+This is the simplest setup and perfect for:
+- Self-hosted, single-user or family deployments
+- Testing and development environments
+- Scenarios where external OAuth providers are not needed
+
+### External Authentication Providers (Optional)
+
+For enterprise or multi-tenant deployments, you can configure external authentication providers. After configuring a provider, you can manage additional authentication methods through the Settings → Admin interface.
+
+### OIDC/OAuth2
+
+```yaml
+config:
+  auth:
+    oidc:
+      enabled: true
+      name: "Authentik"  # Display name
+      issuer: "https://auth.example.com/application/o/norish/"
+      clientId: "<your-client-id>"
+      clientSecret: "<your-client-secret>"
+```
+
+### GitHub OAuth
+
+1. Create a GitHub OAuth App at https://github.com/settings/developers
+2. Set Authorization callback URL to: `https://norish.example.com/api/auth/callback/github`
+
+```yaml
+config:
+  auth:
+    github:
+      enabled: true
+      clientId: "<your-github-client-id>"
+      clientSecret: "<your-github-client-secret>"
+```
+
+### Google OAuth
+
+1. Create OAuth credentials at https://console.cloud.google.com/apis/credentials
+2. Set Authorized redirect URI to: `https://norish.example.com/api/auth/callback/google`
+
+```yaml
+config:
+  auth:
+    google:
+      enabled: true
+      clientId: "<your-google-client-id>"
+      clientSecret: "<your-google-client-secret>"
+```
+
+## Troubleshooting
+
+### Check Pod Status
+
+```bash
+kubectl get pods -l app.kubernetes.io/name=norish
+kubectl logs -l app.kubernetes.io/name=norish
+```
+
+### Check Database Connection
+
+```bash
+# Test connection from app pod
+kubectl exec -it deployment/norish -- sh
+nc -zv <your-postgres-host> 5432
+```
+
+### Common Issues
+
+1. **Master Key Not Set**: Ensure you've generated and configured a master key
+2. **Cannot Log In**:
+   - Password authentication is enabled by default when no OAuth/OIDC is configured
+   - If you configured an external provider, ensure the client ID/secret are correct
+   - Check the callback URL matches your ingress hostname
+3. **Database Connection Failed**:
+   - Verify database host is correct and accessible from the cluster
+   - Check database credentials
+   - Ensure the database exists
+   - Verify network policies allow connections to the database
+4. **Application Not Accessible**: Verify ingress configuration and DNS records
+5. **Chrome Headless Issues**:
+   - Chrome requires `SYS_ADMIN` capability for proper operation
+   - If pod fails to start, check if your cluster's security policies allow the required capabilities
+   - Chrome container may require additional memory (256Mi-512Mi recommended)
+   - Check Chrome container logs: `kubectl logs -l app.kubernetes.io/name=norish -c chrome-headless`
+6. **Recipe Parsing Failures**:
+   - Ensure Chrome headless is running: `kubectl get pods -l app.kubernetes.io/name=norish`
+   - Verify `CHROME_WS_ENDPOINT` is set correctly (automatically configured by the chart)
+   - Check if Chrome is accessible from the Norish container
+
+## Upgrading
+
+To upgrade the chart:
+
+```bash
+$ helm upgrade norish helm-charts/norish -f values.yaml
+```
+
+### Upgrading from v0.13.x to v0.14.x
+
+**BREAKING CHANGE:** Norish v0.14.0+ requires Redis for background job processing.
+
+Before upgrading, you **must** configure Redis:
+
+**Option 1: Using an existing Redis cluster (Recommended for production)**
+
+Update your `values.yaml`:
+
+```yaml
+redis:
+  host: "redis.default.svc.cluster.local"  # Your Redis server
+  port: 6379
+  database: 0
+  # If Redis requires authentication:
+  existingSecret: "my-redis-secret"  # Secret containing redis-url key
+  urlKey: "redis-url"
+```
+
+Create the Redis secret with the full URL:
+
+```bash
+# For Redis with authentication
+kubectl create secret generic my-redis-secret \
+  --from-literal=redis-url="redis://username:password@redis.default.svc.cluster.local:6379/0"
+
+# For Redis without authentication
+kubectl create secret generic my-redis-secret \
+  --from-literal=redis-url="redis://redis.default.svc.cluster.local:6379/0"
+```
+
+**Option 2: Using plain password in values (Simple setup)**
+
+```yaml
+redis:
+  host: "redis.default.svc.cluster.local"
+  port: 6379
+  database: 0
+  username: "default"  # Optional
+  password: "mypassword"  # Chart will auto-generate redis-url
+```
+
+**Option 3: Redis without authentication**
+
+```yaml
+redis:
+  host: "redis.default.svc.cluster.local"
+  port: 6379
+  database: 0
+  # No password or existingSecret - chart will generate simple URL
+```
+
+After configuring Redis, upgrade the chart:
+
+```bash
+$ helm upgrade norish helm-charts/norish -f values.yaml
+```
+
+### What's New in v0.14.x
+
+**Breaking Changes:**
+- Redis is now required for the application to function
+- See the [upgrade guide](#upgrading-from-v013x-to-v014x) above
+
+**New Features:**
+- Recipe improvements:
+  - Full redesign of the recipe desktop page
+  - Recipe linking and headings in description/instruction steps
+  - Attach images to steps as reference material
+  - Keep screen on during cooking
+  - Drag and drop ingredient and step reordering
+  - Manual or AI-powered macro nutrient estimation
+- New creation options:
+  - Recipe creation by image (supports multiple images, requires AI)
+  - Recipe creation via plain recipe text
+  - "Always use AI to import" override in admin settings
+- Allergy MVP:
+  - Users can set allergies in their settings page
+  - Warnings when planning recipes with matching allergies
+- Rating and liking recipes (including filtering)
+
+**Technical Improvements:**
+- Redis + BullMQ for importing and other background tasks
+- Removed puppeteer in favor of playwright
+- All dependencies updated
+- Improved reverse proxy support
+- Rate limiting for brute force attacks
+
+**Bug Fixes:**
+- User menu not opening import modal
+- User menu creation not linking
+- Improved pre-fetching of recipes and virtualization
+
+## Support
+
+- Norish Repository: https://github.com/norishapp/norish
+- Chart Repository: https://github.com/rtomik/helm-charts
+- Issue Tracker: https://github.com/rtomik/helm-charts/issues
+
+## License
+
+This Helm chart is provided as-is under the same license as the Norish application.

charts/norish/templates/NOTES.txt

@@ -0,0 +1,74 @@
+Thank you for installing {{ .Chart.Name }}!
+
+Your release is named {{ .Release.Name }}.
+
+To learn more about the release, try:
+
+  $ helm status {{ .Release.Name }} -n {{ .Release.Namespace }}
+  $ helm get all {{ .Release.Name }} -n {{ .Release.Namespace }}
+
+{{- if .Values.ingress.enabled }}
+
+Application URL:
+{{- range .Values.ingress.hosts }}
+  http{{ if $.Values.ingress.tls }}s{{ end }}://{{ .host }}{{ range .paths }}{{ .path }}{{ end }}
+{{- end }}
+{{- else }}
+
+Get the application URL by running these commands:
+{{- if contains "NodePort" .Values.service.type }}
+  export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "norish.fullname" . }})
+  export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
+  echo http://$NODE_IP:$NODE_PORT
+{{- else if contains "LoadBalancer" .Values.service.type }}
+     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
+           You can watch the status by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "norish.fullname" . }}'
+  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "norish.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
+  echo http://$SERVICE_IP:{{ .Values.service.port }}
+{{- else if contains "ClusterIP" .Values.service.type }}
+  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "norish.name" . }},app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}")
+  export CONTAINER_PORT=$(kubectl get pod --namespace {{ .Release.Namespace }} $POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}")
+  echo "Visit http://127.0.0.1:8080 to use your application"
+  kubectl --namespace {{ .Release.Namespace }} port-forward $POD_NAME 8080:$CONTAINER_PORT
+{{- end }}
+{{- end }}
+
+IMPORTANT CONFIGURATION NOTES:
+
+1. Database Configuration:
+   {{- if .Values.database.host }}
+   Using external PostgreSQL at: {{ .Values.database.host }}:{{ .Values.database.port }}
+   {{- else }}
+   ⚠️  WARNING: Database host is not configured!
+   Configure database.host to point to your PostgreSQL server.
+   {{- end }}
+
+2. Master Key:
+   {{- if .Values.config.masterKey.existingSecret }}
+   Using existing secret: {{ .Values.config.masterKey.existingSecret }}
+   {{- else }}
+   {{- if not .Values.config.masterKey.value }}
+   ⚠️  WARNING: Master key is not set! Generate one with: openssl rand -base64 32
+   {{- else }}
+   Master key configured from values.yaml
+   {{- end }}
+   {{- end }}
+
+3. Authentication:
+   {{- if or .Values.config.auth.oidc.enabled .Values.config.auth.github.enabled .Values.config.auth.google.enabled }}
+   {{- if .Values.config.auth.oidc.enabled }}
+   - OIDC provider: {{ .Values.config.auth.oidc.name }}
+   {{- end }}
+   {{- if .Values.config.auth.github.enabled }}
+   - GitHub OAuth enabled
+   {{- end }}
+   {{- if .Values.config.auth.google.enabled }}
+   - Google OAuth enabled
+   {{- end }}
+   After first login, configure additional providers in Settings → Admin
+   {{- else }}
+   ⚠️  WARNING: No authentication provider configured!
+   Configure ONE provider (OIDC, GitHub, or Google) to create your admin account.
+   {{- end }}
+
+For more information, visit: https://github.com/norishapp/norish

charts/norish/templates/_helpers.tpl

@@ -0,0 +1,97 @@
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "norish.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Create a default fully qualified app name.
+*/}}
+{{- define "norish.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- printf "%s" $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "norish.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Common labels
+*/}}
+{{- define "norish.labels" -}}
+helm.sh/chart: {{ include "norish.chart" . }}
+{{ include "norish.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{/*
+Selector labels
+*/}}
+{{- define "norish.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "norish.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+
+{{/*
+Database connection URL
+*/}}
+{{- define "norish.databaseUrl" -}}
+{{- $username := .Values.database.username }}
+{{- $password := .Values.database.password }}
+{{- $host := .Values.database.host }}
+{{- $port := .Values.database.port }}
+{{- $database := .Values.database.name }}
+{{- printf "postgres://%s:%s@%s:%d/%s" $username $password $host (int $port) $database }}
+{{- end }}
+
+{{/*
+Redis URL (for non-authenticated Redis)
+Constructs the Redis URL without authentication.
+Format: redis://host:port/database
+*/}}
+{{- define "norish.redis.url.noauth" -}}
+{{- $host := .Values.redis.host }}
+{{- $port := .Values.redis.port }}
+{{- $database := .Values.redis.database | toString }}
+{{- printf "redis://%s:%d/%s" $host (int $port) $database }}
+{{- end }}
+
+{{/*
+Check if Redis authentication is configured
+Returns true if either existingSecret or password is set
+*/}}
+{{- define "norish.redis.hasAuth" -}}
+{{- if or .Values.redis.existingSecret .Values.redis.password }}
+{{- "true" }}
+{{- end }}
+{{- end }}
+
+{{/*
+Redis URL with authentication (for secret generation)
+Constructs the Redis URL with password interpolation for use in secrets.
+Format: redis://[username]:[password]@host:port/database
+*/}}
+{{- define "norish.redis.url.withPassword" -}}
+{{- $host := .Values.redis.host }}
+{{- $port := .Values.redis.port }}
+{{- $database := .Values.redis.database | toString }}
+{{- $username := .Values.redis.username | default "" }}
+{{- $password := .Values.redis.password | default "" }}
+{{- if $username }}
+{{- printf "redis://%s:%s@%s:%d/%s" $username $password $host (int $port) $database }}
+{{- else }}
+{{- printf "redis://:%s@%s:%d/%s" $password $host (int $port) $database }}
+{{- end }}
+{{- end }}

charts/norish/templates/deployment-app.yaml

@@ -0,0 +1,292 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "norish.fullname" . }}
+  labels:
+    {{- include "norish.labels" . | nindent 4 }}
+    app.kubernetes.io/component: app
+  annotations:
+    checksum/secret: {{ include (print $.Template.BasePath "/secret.yaml") . | sha256sum }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  revisionHistoryLimit: {{ .Values.revisionHistoryLimit }}
+  selector:
+    matchLabels:
+      {{- include "norish.selectorLabels" . | nindent 6 }}
+  strategy:
+    type: RollingUpdate
+    rollingUpdate:
+      maxUnavailable: 1
+      maxSurge: 1
+  template:
+    metadata:
+      labels:
+        {{- include "norish.selectorLabels" . | nindent 8 }}
+      annotations:
+        checksum/secret: {{ include (print $.Template.BasePath "/secret.yaml") . | sha256sum }}
+        {{- with .Values.podAnnotations }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+    spec:
+      {{- with .Values.imagePullSecrets }}
+      imagePullSecrets:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      securityContext:
+        {{- toYaml .Values.podSecurityContext | nindent 8 }}
+      containers:
+        - name: {{ .Chart.Name }}
+          securityContext:
+            {{- toYaml .Values.containerSecurityContext | nindent 12 }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default .Chart.AppVersion }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.service.port }}
+              protocol: TCP
+          {{- if .Values.probes.startup.enabled }}
+          startupProbe:
+            httpGet:
+              path: {{ .Values.probes.startup.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.startup.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.startup.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.startup.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.startup.failureThreshold }}
+            successThreshold: {{ .Values.probes.startup.successThreshold }}
+          {{- end }}
+          {{- if .Values.probes.liveness.enabled }}
+          livenessProbe:
+            httpGet:
+              path: {{ .Values.probes.liveness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.liveness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.liveness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.liveness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.liveness.failureThreshold }}
+            successThreshold: {{ .Values.probes.liveness.successThreshold }}
+          {{- end }}
+          {{- if .Values.probes.readiness.enabled }}
+          readinessProbe:
+            httpGet:
+              path: {{ .Values.probes.readiness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.readiness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.readiness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.readiness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.readiness.failureThreshold }}
+            successThreshold: {{ .Values.probes.readiness.successThreshold }}
+          {{- end }}
+          env:
+            - name: AUTH_URL
+              value: {{ .Values.config.authUrl | quote }}
+            {{- if .Values.chrome.enabled }}
+            - name: CHROME_WS_ENDPOINT
+              value: "ws://localhost:{{ .Values.chrome.port }}"
+            {{- end }}
+            {{- if .Values.config.logLevel }}
+            - name: NEXT_PUBLIC_LOG_LEVEL
+              value: {{ .Values.config.logLevel | quote }}
+            {{- end }}
+            {{- if .Values.config.trustedOrigins }}
+            - name: TRUSTED_ORIGINS
+              value: {{ .Values.config.trustedOrigins | quote }}
+            {{- end }}
+            {{- if .Values.config.passwordAuthEnabled }}
+            - name: PASSWORD_AUTH_ENABLED
+              value: {{ .Values.config.passwordAuthEnabled | quote }}
+            {{- end }}
+            {{- if .Values.database.existingSecret }}
+            - name: DB_USERNAME
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.database.existingSecret }}
+                  key: {{ .Values.database.usernameKey }}
+            - name: DB_PASSWORD
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.database.existingSecret }}
+                  key: {{ .Values.database.passwordKey }}
+            {{- if .Values.database.databaseKey }}
+            - name: DB_NAME
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.database.existingSecret }}
+                  key: {{ .Values.database.databaseKey }}
+            {{- else }}
+            - name: DB_NAME
+              value: {{ .Values.database.name | quote }}
+            {{- end }}
+            {{- if .Values.database.hostKey }}
+            - name: DB_HOST
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.database.existingSecret }}
+                  key: {{ .Values.database.hostKey }}
+            {{- else }}
+            - name: DB_HOST
+              value: {{ .Values.database.host | quote }}
+            {{- end }}
+            - name: DB_PORT
+              value: {{ .Values.database.port | quote }}
+            - name: DATABASE_URL
+              value: "postgres://$(DB_USERNAME):$(DB_PASSWORD)@$(DB_HOST):$(DB_PORT)/$(DB_NAME)"
+            {{- else }}
+            - name: DATABASE_URL
+              value: {{ include "norish.databaseUrl" . | quote }}
+            {{- end }}
+            - name: MASTER_KEY
+              valueFrom:
+                secretKeyRef:
+                  {{- if .Values.config.masterKey.existingSecret }}
+                  name: {{ .Values.config.masterKey.existingSecret }}
+                  key: {{ .Values.config.masterKey.secretKey }}
+                  {{- else }}
+                  name: {{ include "norish.fullname" . }}-secret
+                  key: master-key
+                  {{- end }}
+            - name: REDIS_URL
+              valueFrom:
+                secretKeyRef:
+                  {{- if .Values.redis.existingSecret }}
+                  name: {{ .Values.redis.existingSecret }}
+                  key: {{ .Values.redis.urlKey | default "redis-url" }}
+                  {{- else }}
+                  name: {{ include "norish.fullname" . }}-secret
+                  key: redis-url
+                  {{- end }}
+            {{- if .Values.config.auth.oidc.enabled }}
+            - name: OIDC_NAME
+              value: {{ .Values.config.auth.oidc.name | quote }}
+            - name: OIDC_ISSUER
+              value: {{ .Values.config.auth.oidc.issuer | quote }}
+            {{- if .Values.config.auth.oidc.wellKnown }}
+            - name: OIDC_WELLKNOWN
+              value: {{ .Values.config.auth.oidc.wellKnown | quote }}
+            {{- end }}
+            - name: OIDC_CLIENT_ID
+              valueFrom:
+                secretKeyRef:
+                  {{- if .Values.config.auth.oidc.existingSecret }}
+                  name: {{ .Values.config.auth.oidc.existingSecret }}
+                  key: {{ .Values.config.auth.oidc.clientIdKey }}
+                  {{- else }}
+                  name: {{ include "norish.fullname" . }}-secret
+                  key: oidc-client-id
+                  {{- end }}
+            - name: OIDC_CLIENT_SECRET
+              valueFrom:
+                secretKeyRef:
+                  {{- if .Values.config.auth.oidc.existingSecret }}
+                  name: {{ .Values.config.auth.oidc.existingSecret }}
+                  key: {{ .Values.config.auth.oidc.clientSecretKey }}
+                  {{- else }}
+                  name: {{ include "norish.fullname" . }}-secret
+                  key: oidc-client-secret
+                  {{- end }}
+            {{- end }}
+            {{- if .Values.config.auth.github.enabled }}
+            - name: GITHUB_CLIENT_ID
+              valueFrom:
+                secretKeyRef:
+                  {{- if .Values.config.auth.github.existingSecret }}
+                  name: {{ .Values.config.auth.github.existingSecret }}
+                  key: {{ .Values.config.auth.github.clientIdKey }}
+                  {{- else }}
+                  name: {{ include "norish.fullname" . }}-secret
+                  key: github-client-id
+                  {{- end }}
+            - name: GITHUB_CLIENT_SECRET
+              valueFrom:
+                secretKeyRef:
+                  {{- if .Values.config.auth.github.existingSecret }}
+                  name: {{ .Values.config.auth.github.existingSecret }}
+                  key: {{ .Values.config.auth.github.clientSecretKey }}
+                  {{- else }}
+                  name: {{ include "norish.fullname" . }}-secret
+                  key: github-client-secret
+                  {{- end }}
+            {{- end }}
+            {{- if .Values.config.auth.google.enabled }}
+            - name: GOOGLE_CLIENT_ID
+              valueFrom:
+                secretKeyRef:
+                  {{- if .Values.config.auth.google.existingSecret }}
+                  name: {{ .Values.config.auth.google.existingSecret }}
+                  key: {{ .Values.config.auth.google.clientIdKey }}
+                  {{- else }}
+                  name: {{ include "norish.fullname" . }}-secret
+                  key: google-client-id
+                  {{- end }}
+            - name: GOOGLE_CLIENT_SECRET
+              valueFrom:
+                secretKeyRef:
+                  {{- if .Values.config.auth.google.existingSecret }}
+                  name: {{ .Values.config.auth.google.existingSecret }}
+                  key: {{ .Values.config.auth.google.clientSecretKey }}
+                  {{- else }}
+                  name: {{ include "norish.fullname" . }}-secret
+                  key: google-client-secret
+                  {{- end }}
+            {{- end }}
+            {{- with .Values.config.extraEnv }}
+            {{- toYaml . | nindent 12 }}
+            {{- end }}
+          volumeMounts:
+            - name: uploads
+              mountPath: /app/uploads
+            {{- with .Values.extraVolumeMounts }}
+            {{- toYaml . | nindent 12 }}
+            {{- end }}
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+        {{- if .Values.chrome.enabled }}
+        - name: chrome-headless
+          image: "{{ .Values.chrome.image.repository }}:{{ .Values.chrome.image.tag }}"
+          imagePullPolicy: {{ .Values.chrome.image.pullPolicy }}
+          securityContext:
+            {{- toYaml .Values.chrome.securityContext | nindent 12 }}
+          ports:
+            - name: chrome
+              containerPort: {{ .Values.chrome.port }}
+              protocol: TCP
+          command:
+            - chromium-browser
+          args:
+            - "--no-sandbox"
+            - "--disable-gpu"
+            - "--disable-dev-shm-usage"
+            - "--remote-debugging-address=0.0.0.0"
+            - "--remote-debugging-port={{ .Values.chrome.port }}"
+            - "--headless"
+          resources:
+            {{- toYaml .Values.chrome.resources | nindent 12 }}
+        {{- end }}
+      volumes:
+        {{- if .Values.persistence.enabled }}
+        - name: uploads
+          persistentVolumeClaim:
+            {{- if .Values.persistence.existingClaim }}
+            claimName: {{ .Values.persistence.existingClaim }}
+            {{- else }}
+            claimName: {{ include "norish.fullname" . }}-uploads
+            {{- end }}
+        {{- else }}
+        - name: uploads
+          emptyDir: {}
+        {{- end }}
+        {{- with .Values.extraVolumes }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+      {{- with .Values.nodeSelector }}
+      nodeSelector:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.affinity }}
+      affinity:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.tolerations }}
+      tolerations:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}

charts/norish/templates/ingress.yaml

@@ -0,0 +1,43 @@
+{{- if .Values.ingress.enabled -}}
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: {{ include "norish.fullname" . }}
+  labels:
+    {{- include "norish.labels" . | nindent 4 }}
+  {{- with .Values.ingress.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  {{- if .Values.ingress.className }}
+  ingressClassName: {{ .Values.ingress.className }}
+  {{- end }}
+  {{- if .Values.ingress.tls }}
+  tls:
+    {{- range .Values.ingress.tls }}
+    - hosts:
+        {{- range .hosts }}
+        - {{ . | quote }}
+        {{- end }}
+      {{- if .secretName }}
+      secretName: {{ .secretName }}
+      {{- end }}
+    {{- end }}
+  {{- end }}
+  rules:
+    {{- range .Values.ingress.hosts }}
+    - host: {{ .host | quote }}
+      http:
+        paths:
+          {{- range .paths }}
+          - path: {{ .path }}
+            pathType: {{ .pathType }}
+            backend:
+              service:
+                name: {{ include "norish.fullname" $ }}
+                port:
+                  number: {{ $.Values.service.port }}
+          {{- end }}
+    {{- end }}
+{{- end }}

charts/norish/templates/pvc.yaml

@@ -0,0 +1,22 @@
+{{- if and .Values.persistence.enabled (not .Values.persistence.existingClaim) }}
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: {{ include "norish.fullname" . }}-uploads
+  labels:
+    {{- include "norish.labels" . | nindent 4 }}
+    app.kubernetes.io/component: app
+  {{- with .Values.persistence.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  accessModes:
+    - {{ .Values.persistence.accessMode }}
+  {{- if .Values.persistence.storageClass }}
+  storageClassName: {{ .Values.persistence.storageClass }}
+  {{- end }}
+  resources:
+    requests:
+      storage: {{ .Values.persistence.size }}
+{{- end }}

charts/norish/templates/secret.yaml

@@ -0,0 +1,39 @@
+apiVersion: v1
+kind: Secret
+metadata:
+  name: {{ include "norish.fullname" . }}-secret
+  labels:
+    {{- include "norish.labels" . | nindent 4 }}
+type: Opaque
+stringData:
+  {{- if not .Values.config.masterKey.existingSecret }}
+  master-key: {{ .Values.config.masterKey.value | required "config.masterKey.value is required when config.masterKey.existingSecret is not set" | quote }}
+  {{- end }}
+  {{- if not .Values.database.existingSecret }}
+  database-url: {{ include "norish.databaseUrl" . | quote }}
+  {{- end }}
+  {{- if not .Values.redis.existingSecret }}
+  {{- if .Values.redis.password }}
+  redis-url: {{ include "norish.redis.url.withPassword" . | quote }}
+  {{- else }}
+  redis-url: {{ include "norish.redis.url.noauth" . | quote }}
+  {{- end }}
+  {{- end }}
+  {{- if .Values.config.auth.oidc.enabled }}
+  {{- if not .Values.config.auth.oidc.existingSecret }}
+  oidc-client-id: {{ .Values.config.auth.oidc.clientId | quote }}
+  oidc-client-secret: {{ .Values.config.auth.oidc.clientSecret | quote }}
+  {{- end }}
+  {{- end }}
+  {{- if .Values.config.auth.github.enabled }}
+  {{- if not .Values.config.auth.github.existingSecret }}
+  github-client-id: {{ .Values.config.auth.github.clientId | quote }}
+  github-client-secret: {{ .Values.config.auth.github.clientSecret | quote }}
+  {{- end }}
+  {{- end }}
+  {{- if .Values.config.auth.google.enabled }}
+  {{- if not .Values.config.auth.google.existingSecret }}
+  google-client-id: {{ .Values.config.auth.google.clientId | quote }}
+  google-client-secret: {{ .Values.config.auth.google.clientSecret | quote }}
+  {{- end }}
+  {{- end }}

charts/norish/templates/service.yaml

@@ -0,0 +1,20 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "norish.fullname" . }}
+  labels:
+    {{- include "norish.labels" . | nindent 4 }}
+    app.kubernetes.io/component: app
+  {{- with .Values.service.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  type: {{ .Values.service.type }}
+  ports:
+    - port: {{ .Values.service.port }}
+      targetPort: http
+      protocol: TCP
+      name: http
+  selector:
+    {{- include "norish.selectorLabels" . | nindent 4 }}

charts/norish/values.yaml

@@ -0,0 +1,259 @@
+## Global settings
+nameOverride: ""
+fullnameOverride: ""
+
+## Image settings
+image:
+  repository: norishapp/norish
+  tag: "v0.15.4-beta"
+  pullPolicy: IfNotPresent
+
+imagePullSecrets: []
+
+## Deployment settings
+replicaCount: 1
+revisionHistoryLimit: 3
+
+# Pod security settings
+podSecurityContext:
+  runAsNonRoot: true
+  runAsUser: 1000
+  fsGroup: 1000
+
+containerSecurityContext:
+  allowPrivilegeEscalation: false
+  readOnlyRootFilesystem: false
+  capabilities:
+    drop:
+      - ALL
+
+## Pod scheduling
+nodeSelector: {}
+tolerations: []
+affinity: {}
+
+## Pod annotations
+podAnnotations: {}
+
+## Service settings
+service:
+  type: ClusterIP
+  port: 3000
+  annotations: {}
+
+## Ingress settings
+ingress:
+  enabled: false
+  className: ""
+  annotations:
+    traefik.ingress.kubernetes.io/router.entrypoints: websecure
+  hosts:
+    - host: norish.domain.com
+      paths:
+        - path: /
+          pathType: Prefix
+  tls:
+    - hosts:
+        - norish.domain.com
+      # Optional: specify the name of an existing TLS secret
+      # secretName: "existing-tls-secret"
+
+## Persistence settings
+persistence:
+  enabled: true
+  # Use an existing PVC instead of creating a new one
+  existingClaim: ""
+  storageClass: ""
+  accessMode: ReadWriteOnce
+  size: 5Gi
+  annotations: {}
+
+# Extra volume mounts
+extraVolumeMounts: []
+
+# Extra volumes
+extraVolumes: []
+
+## Resource limits and requests
+resources: {}
+  # We usually recommend not to specify default resources and to leave this as a conscious
+  # choice for the user. This also increases chances charts run on environments with little
+  # resources, such as Minikube. If you do want to specify resources, uncomment the following
+  # lines, adjust them as necessary, and remove the curly braces after 'resources:'.
+  # limits:
+  #   cpu: 500m
+  #   memory: 512Mi
+  # requests:
+  #   cpu: 100m
+  #   memory: 128Mi
+
+## Application health checks
+probes:
+  startup:
+    enabled: true
+    initialDelaySeconds: 10
+    periodSeconds: 10
+    timeoutSeconds: 5
+    failureThreshold: 30
+    successThreshold: 1
+    path: /
+  liveness:
+    enabled: true
+    initialDelaySeconds: 30
+    periodSeconds: 10
+    timeoutSeconds: 5
+    failureThreshold: 6
+    successThreshold: 1
+    path: /
+  readiness:
+    enabled: true
+    initialDelaySeconds: 5
+    periodSeconds: 5
+    timeoutSeconds: 3
+    failureThreshold: 3
+    successThreshold: 1
+    path: /
+
+## Application configuration
+config:
+  # Application URL (required)
+  # This should match your ingress hostname
+  authUrl: "http://norish.domain.com"
+
+  # Extra environment variables
+  # Example:
+  # extraEnv:
+  #   - name: MY_CUSTOM_VAR
+  #     value: "my-value"
+  #   - name: SECRET_VAR
+  #     valueFrom:
+  #       secretKeyRef:
+  #         name: my-secret
+  #         key: secret-key
+  extraEnv: []
+
+  # Master encryption key (required)
+  # Generate with: openssl rand -base64 32
+  # For production, use an existing Kubernetes Secret
+  masterKey:
+    existingSecret: ""        # Name of existing Kubernetes secret
+    secretKey: "master-key"   # Key in the secret where master key is stored
+    value: ""                 # Only used if existingSecret is not set (must be 32-byte base64)
+
+  # Optional configuration
+  # Log level: trace, debug, info, warn, error, fatal
+  # Defaults to info in production, debug in development
+  logLevel: ""
+
+  # Additional trusted origins (comma-separated)
+  # Useful when behind a proxy or using multiple domains
+  # Example: "http://192.168.1.100:3000,https://norish.example.com"
+  trustedOrigins: ""
+
+  # Enable/disable password authentication
+  # Defaults to false if OIDC or OAuth is configured, true otherwise
+  passwordAuthEnabled: ""
+
+  # Authentication provider configuration
+  # Configure ONE provider for initial admin account creation
+  # After first login, manage additional providers via Settings → Admin
+  auth:
+    # OIDC/OAuth2 provider
+    oidc:
+      enabled: false
+      name: "MyAuth"
+      issuer: ""
+      clientId: ""
+      clientSecret: ""
+      # Optional: OIDC well-known configuration URL
+      # By default derived from issuer by appending /.well-known/openid-configuration
+      wellKnown: ""
+      # Use existing secret for OIDC credentials
+      existingSecret: ""
+      clientIdKey: "oidc-client-id"
+      clientSecretKey: "oidc-client-secret"
+
+    # GitHub OAuth
+    github:
+      enabled: false
+      clientId: ""
+      clientSecret: ""
+      # Use existing secret for GitHub credentials
+      existingSecret: ""
+      clientIdKey: "github-client-id"
+      clientSecretKey: "github-client-secret"
+
+    # Google OAuth
+    google:
+      enabled: false
+      clientId: ""
+      clientSecret: ""
+      # Use existing secret for Google credentials
+      existingSecret: ""
+      clientIdKey: "google-client-id"
+      clientSecretKey: "google-client-secret"
+
+## External PostgreSQL database configuration (REQUIRED)
+## Norish requires a central PostgreSQL database
+## You must have a PostgreSQL server available before deploying this chart
+database:
+  # Database connection details
+  host: ""                    # Required: PostgreSQL server hostname
+  port: 5432
+  name: norish
+  username: postgres
+  password: ""
+
+  # Use existing secret for database credentials (recommended for production)
+  existingSecret: ""          # Name of existing Kubernetes secret
+  usernameKey: "username"     # Key in the secret for database username
+  passwordKey: "password"     # Key in the secret for database password
+  databaseKey: "database"     # Key in the secret for database name (optional)
+  hostKey: ""             # Key in the secret for database host (optional)
+
+## External Redis configuration (REQUIRED for v0.14.0+)
+## Redis is required for job queues and background tasks starting from v0.14.0-beta
+redis:
+  # Redis connection details
+  host: ""                    # Required: Redis server hostname
+  port: 6379
+  database: 0
+  # Authentication (leave empty if Redis has no auth)
+  username: ""                # Optional: Redis username (Redis 6.0+)
+  password: ""                # Redis password (leave empty if no auth)
+
+  # Use existing secret for Redis credentials (recommended for production)
+  # NOTE: When using existingSecret, the secret MUST contain a key with the full Redis URL
+  #       Format: redis://[username]:[password]@host:port/database
+  existingSecret: ""          # Name of existing Kubernetes secret
+  urlKey: "redis-url"         # Key in existingSecret containing the full Redis URL
+  passwordKey: "password"     # Key in existingSecret for password (for compatibility)
+
+## Chrome Headless configuration (REQUIRED)
+## Required for improved recipe parsing and scraping
+chrome:
+  enabled: true
+  image:
+    repository: zenika/alpine-chrome
+    tag: "latest"
+    pullPolicy: IfNotPresent
+
+  # Chrome port for remote debugging
+  port: 9222
+
+  # Chrome security context - requires specific capabilities
+  securityContext:
+    runAsNonRoot: false
+    runAsUser: 0
+    capabilities:
+      add:
+        - SYS_ADMIN
+
+  # Chrome resource limits
+  resources: {}
+    # limits:
+    #   cpu: 500m
+    #   memory: 512Mi
+    # requests:
+    #   cpu: 100m
+    #   memory: 256Mi

charts/paperless-ngx/Chart.yaml

@@ -2,11 +2,11 @@ apiVersion: v2
 name: paperless-ngx
 description: Paperless-ngx helm chart for Kubernetes
 type: application
-version: 0.0.1
+version: 0.0.5
-appVersion: "latest"
+appVersion: "2.20.3"
 maintainers:
   - name: Richard Tomik
-    email: no@m.com
+    email: richard.tomik@proton.me
 keywords:
   - productivity
   - document-management

charts/paperless-ngx/readme.md

@@ -32,6 +32,13 @@ Paperless-ngx requires PostgreSQL 11+ as its database backend. Ensure you have:
 Redis is required for background task processing. Ensure you have:
 - A Redis server accessible from the cluster
 - Connection details configured in values.yaml
+- Optional: Redis authentication credentials (username/password)
+- Optional: Redis key prefix for sharing one Redis server among multiple Paperless instances
+
+The chart supports all Redis authentication methods:
+- No authentication: `redis://host:port/database`
+- Password only (requirepass): `redis://:password@host:port/database`
+- Username and password (Redis 6.0+ ACL): `redis://username:password@host:port/database`
 
 ## Installing the Chart
 
@@ -86,6 +93,11 @@ The following table lists the configurable parameters and their default values.
 | `redis.external.host`                 | External Redis host                                                | `redis.default.svc.cluster.local`        |
 | `redis.external.port`                 | External Redis port                                                | `6379`                                    |
 | `redis.external.database`             | External Redis database number                                     | `0`                                       |
+| `redis.external.username`             | Redis username (Redis 6.0+ with ACL)                               | `""`                                      |
+| `redis.external.password`             | Redis password (leave empty if no auth required)                   | `""`                                      |
+| `redis.external.existingSecret`       | Existing secret with Redis credentials                             | `""`                                      |
+| `redis.external.passwordKey`          | Key in existing secret for Redis password                          | `redis-password`                          |
+| `redis.external.prefix`               | Prefix for Redis keys/channels (for multi-instance)                | `""`                                      |
 
 ### Security Configuration
 
@@ -115,12 +127,16 @@ The following table lists the configurable parameters and their default values.
 | Name                                   | Description                                                        | Value               |
 |----------------------------------------|--------------------------------------------------------------------|---------------------|
 | `persistence.data.enabled`            | Enable persistence for data directory                             | `true`              |
+| `persistence.data.existingClaim`      | Use an existing PVC for data directory                            | `""`                |
 | `persistence.data.size`               | Size of data PVC                                                  | `1Gi`               |
 | `persistence.media.enabled`           | Enable persistence for media directory                            | `true`              |
+| `persistence.media.existingClaim`     | Use an existing PVC for media directory                           | `""`                |
 | `persistence.media.size`              | Size of media PVC                                                 | `10Gi`              |
 | `persistence.consume.enabled`         | Enable persistence for consume directory                          | `true`              |
+| `persistence.consume.existingClaim`   | Use an existing PVC for consume directory                         | `""`                |
 | `persistence.consume.size`            | Size of consume PVC                                               | `5Gi`               |
 | `persistence.export.enabled`          | Enable persistence for export directory                           | `true`              |
+| `persistence.export.existingClaim`    | Use an existing PVC for export directory                          | `""`                |
 | `persistence.export.size`             | Size of export PVC                                                | `1Gi`               |
 
 ### Service Parameters
@@ -166,14 +182,27 @@ config:
     existingSecret: "paperless-admin-secrets"
 
 postgresql:
+  # External PostgreSQL connection details
   external:
-    host: "postgresql.database.svc.cluster.local"
+    enabled: true
-    existingSecret: "paperless-db-secrets"
+    host: "postgres-cluster-pooler.dbs.svc.cluster.local"
+    port: 5432
+    database: "paperless"
+    username: "paperless"
+    # Use existingSecret for credentials
+    existingSecret: "paperless-db-credentials"
     passwordKey: "password"
 
 redis:
   external:
     host: "redis.cache.svc.cluster.local"
+    port: 6379
+    database: 0
+    # Use existingSecret for Redis credentials
+    existingSecret: "paperless-redis-credentials"
+    passwordKey: "password"
+    # Optional: Use prefix to share Redis among multiple instances
+    prefix: "paperless-prod"
 
 ingress:
   enabled: true
@@ -193,13 +222,63 @@ ingress:
 helm install paperless-ngx . -f values-production.yaml
 ```
 
+### Redis Authentication Examples
+
+#### Redis with Password Only (requirepass)
+
+```bash
+helm install paperless-ngx . \
+  --set redis.external.host=redis.example.com \
+  --set redis.external.password=myredispassword
+```
+
+Or with existing secret:
+
+```yaml
+redis:
+  external:
+    host: "redis.example.com"
+    existingSecret: "redis-auth-secret"
+    passwordKey: "redis-password"
+```
+
+#### Redis with Username and Password (Redis 6.0+ ACL)
+
+```bash
+helm install paperless-ngx . \
+  --set redis.external.host=redis.example.com \
+  --set redis.external.username=paperless-user \
+  --set redis.external.password=myredispassword
+```
+
+#### Multiple Paperless Instances on One Redis Server
+
+Use the `prefix` parameter to avoid key collisions:
+
+```yaml
+# Instance 1
+redis:
+  external:
+    host: "shared-redis.example.com"
+    password: "sharedpassword"
+    prefix: "paperless-prod"
+
+# Instance 2
+redis:
+  external:
+    host: "shared-redis.example.com"
+    password: "sharedpassword"
+    prefix: "paperless-staging"
+```
+
 ## Security Considerations
 
-1. **Use external secrets** for production deployments to store sensitive data like database passwords and the Django secret key.
+1. **Use external secrets** for production deployments to store sensitive data like database passwords, Redis passwords, and the Django secret key.
 2. **Set a proper PAPERLESS_URL** when exposing the application externally.
 3. **Configure ALLOWED_HOSTS** to restrict which hosts can access the application.
 4. **Use HTTPS** when exposing the application to the internet.
-5. **Container Security**: The container runs as root initially to allow s6-overlay to set up the runtime environment, then drops privileges to UID 1000. This is required for the Paperless-ngx Docker image to function properly.
+5. **Secure Redis**: Always use authentication (password or username/password) for Redis in production environments. Use `existingSecret` instead of plain text passwords.
+6. **Container Security**: The container runs as root initially to allow s6-overlay to set up the runtime environment, then drops privileges to UID 1000. This is required for the Paperless-ngx Docker image to function properly.
 
 ## Volumes and Data
 
@@ -212,6 +291,37 @@ Paperless-ngx uses several directories:
 
 All directories can be configured with separate PVCs and storage classes.
 
+### Using Existing PVCs
+
+The chart supports using existing PersistentVolumeClaims instead of creating new ones. This is useful for:
+- Migrating from an existing Paperless-ngx deployment
+- Using pre-provisioned storage with specific settings
+- Sharing volumes across deployments
+
+To use an existing PVC, specify the `existingClaim` parameter for the relevant volume:
+
+```yaml
+persistence:
+  data:
+    enabled: true
+    existingClaim: "my-existing-data-pvc"
+  media:
+    enabled: true
+    existingClaim: "my-existing-media-pvc"
+  export:
+    enabled: true
+    existingClaim: ""  # Will create new PVC
+  consume:
+    enabled: true
+    existingClaim: ""  # Will create new PVC
+```
+
+When `existingClaim` is specified:
+- The chart will **NOT** create a new PVC
+- The specified PVC must already exist in the same namespace
+- `storageClass`, `size`, and `accessMode` parameters are ignored for that volume
+- You can mix existing and new PVCs (some volumes with `existingClaim`, others without)
+
 ## Uninstalling the Chart
 
 To uninstall/delete the `paperless-ngx` deployment:

charts/paperless-ngx/templates/_helpers.tpl

@@ -89,11 +89,42 @@ Redis port
 {{- end }}
 
 {{/*
-Redis URL
+Redis URL (for non-authenticated Redis)
+Constructs the Redis URL without authentication.
+Format: redis://host:port/database
 */}}
-{{- define "paperless-ngx.redis.url" -}}
+{{- define "paperless-ngx.redis.url.noauth" -}}
 {{- $host := include "paperless-ngx.redis.host" . }}
 {{- $port := include "paperless-ngx.redis.port" . }}
 {{- $database := .Values.redis.external.database | toString }}
 {{- printf "redis://%s:%s/%s" $host $port $database }}
+{{- end }}
+
+{{/*
+Check if Redis authentication is configured
+Returns true if either existingSecret or password is set
+*/}}
+{{- define "paperless-ngx.redis.hasAuth" -}}
+{{- if or .Values.redis.external.existingSecret .Values.redis.external.password }}
+{{- "true" }}
+{{- end }}
+{{- end }}
+
+{{/*
+Redis URL with authentication (for secret generation)
+Constructs the Redis URL with password interpolation for use in secrets.
+This uses the actual password value when building the secret.
+Format: redis://[username]:[password]@host:port/database
+*/}}
+{{- define "paperless-ngx.redis.url.withPassword" -}}
+{{- $host := include "paperless-ngx.redis.host" . }}
+{{- $port := include "paperless-ngx.redis.port" . }}
+{{- $database := .Values.redis.external.database | toString }}
+{{- $username := .Values.redis.external.username | default "" }}
+{{- $password := .Values.redis.external.password | default "" }}
+{{- if $username }}
+{{- printf "redis://%s:%s@%s:%s/%s" $username $password $host $port $database }}
+{{- else }}
+{{- printf "redis://:%s@%s:%s/%s" $password $host $port $database }}
+{{- end }}
 {{- end }}

charts/paperless-ngx/templates/deployment.yaml

@@ -67,8 +67,23 @@ spec:
           {{- end }}
           env:
             # Required services
+            {{- if include "paperless-ngx.redis.hasAuth" . }}
+            # When Redis has authentication, read the full URL from secret
             - name: PAPERLESS_REDIS
-              value: {{ include "paperless-ngx.redis.url" . | quote }}
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.redis.external.existingSecret | default (printf "%s-secrets" (include "paperless-ngx.fullname" .)) }}
+                  key: {{ .Values.redis.external.urlKey | default "redis-url" }}
+            {{- else }}
+            # When Redis has no authentication, use the simple URL
+            - name: PAPERLESS_REDIS
+              value: {{ include "paperless-ngx.redis.url.noauth" . | quote }}
+            {{- end }}
+            {{- if .Values.redis.external.prefix }}
+            - name: PAPERLESS_REDIS_PREFIX
+              value: {{ .Values.redis.external.prefix | quote }}
+            {{- end }}
+
             - name: PAPERLESS_DBHOST
               value: {{ include "paperless-ngx.postgresql.host" . | quote }}
             - name: PAPERLESS_DBPORT
@@ -320,7 +335,7 @@ spec:
         {{- if .Values.persistence.data.enabled }}
         - name: data
           persistentVolumeClaim:
-            claimName: {{ include "paperless-ngx.fullname" . }}-data
+            claimName: {{ if .Values.persistence.data.existingClaim }}{{ .Values.persistence.data.existingClaim }}{{ else }}{{ include "paperless-ngx.fullname" . }}-data{{ end }}
         {{- else }}
         - name: data
           emptyDir: {}
@@ -328,7 +343,7 @@ spec:
         {{- if .Values.persistence.media.enabled }}
         - name: media
           persistentVolumeClaim:
-            claimName: {{ include "paperless-ngx.fullname" . }}-media
+            claimName: {{ if .Values.persistence.media.existingClaim }}{{ .Values.persistence.media.existingClaim }}{{ else }}{{ include "paperless-ngx.fullname" . }}-media{{ end }}
         {{- else }}
         - name: media
           emptyDir: {}
@@ -336,7 +351,7 @@ spec:
         {{- if .Values.persistence.export.enabled }}
         - name: export
           persistentVolumeClaim:
-            claimName: {{ include "paperless-ngx.fullname" . }}-export
+            claimName: {{ if .Values.persistence.export.existingClaim }}{{ .Values.persistence.export.existingClaim }}{{ else }}{{ include "paperless-ngx.fullname" . }}-export{{ end }}
         {{- else }}
         - name: export
           emptyDir: {}
@@ -344,7 +359,7 @@ spec:
         {{- if .Values.persistence.consume.enabled }}
         - name: consume
           persistentVolumeClaim:
-            claimName: {{ include "paperless-ngx.fullname" . }}-consume
+            claimName: {{ if .Values.persistence.consume.existingClaim }}{{ .Values.persistence.consume.existingClaim }}{{ else }}{{ include "paperless-ngx.fullname" . }}-consume{{ end }}
         {{- else }}
         - name: consume
           emptyDir: {}

charts/paperless-ngx/templates/pvc.yaml

@@ -1,4 +1,4 @@
-{{- if .Values.persistence.data.enabled }}
+{{- if and .Values.persistence.data.enabled (not .Values.persistence.data.existingClaim) }}
 apiVersion: v1
 kind: PersistentVolumeClaim
 metadata:
@@ -21,7 +21,7 @@ spec:
 ---
 {{- end }}
 
-{{- if .Values.persistence.media.enabled }}
+{{- if and .Values.persistence.media.enabled (not .Values.persistence.media.existingClaim) }}
 apiVersion: v1
 kind: PersistentVolumeClaim
 metadata:
@@ -44,7 +44,7 @@ spec:
 ---
 {{- end }}
 
-{{- if .Values.persistence.export.enabled }}
+{{- if and .Values.persistence.export.enabled (not .Values.persistence.export.existingClaim) }}
 apiVersion: v1
 kind: PersistentVolumeClaim
 metadata:
@@ -67,7 +67,7 @@ spec:
 ---
 {{- end }}
 
-{{- if .Values.persistence.consume.enabled }}
+{{- if and .Values.persistence.consume.enabled (not .Values.persistence.consume.existingClaim) }}
 apiVersion: v1
 kind: PersistentVolumeClaim
 metadata:

charts/paperless-ngx/templates/secret.yaml

@@ -5,6 +5,9 @@
 {{- if not .Values.postgresql.external.existingSecret -}}
   {{- $needsSecret = true -}}
 {{- end -}}
+{{- if and .Values.redis.external.password (not .Values.redis.external.existingSecret) -}}
+  {{- $needsSecret = true -}}
+{{- end -}}
 {{- if and .Values.config.admin.user (not .Values.config.admin.existingSecret) -}}
   {{- $needsSecret = true -}}
 {{- end -}}
@@ -27,6 +30,10 @@ data:
   {{- if not .Values.postgresql.external.existingSecret }}
   {{ .Values.postgresql.external.passwordKey | default "postgresql-password" }}: {{ .Values.postgresql.external.password | default "paperless" | b64enc }}
   {{- end }}
+  {{- if and .Values.redis.external.password (not .Values.redis.external.existingSecret) }}
+  {{ .Values.redis.external.passwordKey | default "redis-password" }}: {{ .Values.redis.external.password | b64enc }}
+  {{ .Values.redis.external.urlKey | default "redis-url" }}: {{ include "paperless-ngx.redis.url.withPassword" . | b64enc }}
+  {{- end }}
   {{- if and .Values.config.admin.user (not .Values.config.admin.existingSecret) }}
   {{ .Values.config.admin.userKey | default "admin-user" }}: {{ .Values.config.admin.user | b64enc }}
   {{ .Values.config.admin.passwordKey | default "admin-password" }}: {{ .Values.config.admin.password | default "changeme" | b64enc }}

charts/paperless-ngx/values.yaml

@@ -5,7 +5,7 @@ fullnameOverride: ""
 ## Image settings
 image:
   repository: ghcr.io/paperless-ngx/paperless-ngx
-  tag: "2.18.4"
+  tag: "2.20.3"
   pullPolicy: IfNotPresent
 
 ## Deployment settings
@@ -65,6 +65,7 @@ persistence:
   # Paperless data directory (search index, classification model, etc.)
   data:
     enabled: true
+    existingClaim: ""
     storageClass: ""
     accessMode: ReadWriteOnce
     size: 1Gi
@@ -72,6 +73,7 @@ persistence:
   # Paperless media directory (documents and thumbnails)
   media:
     enabled: true
+    existingClaim: ""
     storageClass: ""
     accessMode: ReadWriteOnce
     size: 10Gi
@@ -79,6 +81,7 @@ persistence:
   # Export directory (for exporting documents)
   export:
     enabled: true
+    existingClaim: ""
     storageClass: ""
     accessMode: ReadWriteOnce
     size: 1Gi
@@ -86,6 +89,7 @@ persistence:
   # Consume directory (for importing documents)
   consume:
     enabled: true
+    existingClaim: ""
     storageClass: ""
     accessMode: ReadWriteOnce
     size: 5Gi
@@ -158,11 +162,20 @@ redis:
     host: "redis.default.svc.cluster.local"
     port: 6379
     database: 0
+    # Authentication (leave empty if Redis has no auth)
+    username: ""  # Optional: Redis username (Redis 6.0+)
     # Use existingSecret for credentials if Redis has auth
+    # NOTE: When using existingSecret, the secret MUST contain a key with the full Redis URL
+    #       Format: redis://[username]:[password]@host:port/database
     existingSecret: ""
-    passwordKey: "redis-password"
+    urlKey: "redis-url"  # Key in existingSecret containing the full Redis URL
+    passwordKey: "redis-password"  # Key in existingSecret for password (for compatibility)
     # Or set password directly (leave empty if no auth)
+    # When using plain password, the full Redis URL will be auto-generated in the secret
     password: ""
+    # Optional: Prefix for Redis keys and channels
+    # Useful for sharing one Redis server among multiple Paperless instances
+    prefix: ""
 
 ## Paperless-ngx Configuration
 config:

charts/qbittorrent-vpn/Chart.yaml

@@ -2,7 +2,7 @@ apiVersion: v2
 name: qbittorrent-vpn
 description: qBittorrent with Gluetun VPN sidecar for Kubernetes
 type: application
-version: 0.0.1
+version: 0.0.2
 appVersion: 5.1.0
 maintainers:
   - name: Richard Tomik

charts/qbittorrent-vpn/readme.md

@@ -222,6 +222,45 @@ gluetun:
     STATUS_FILE: "/tmp/gluetun-status.json"
 ```
 
+### Custom Sidecar Containers
+
+The chart supports adding custom sidecar containers to the pod. This is useful for adding additional functionality like port forwarding management (NATMap), monitoring, or other helper containers.
+
+Sidecars are specified using the standard Kubernetes container specification:
+
+```yaml
+sidecars:
+  - name: natmap
+    image: ghcr.io/muink/natmap:latest
+    imagePullPolicy: IfNotPresent
+    env:
+      - name: GATEWAY
+        value: "10.2.0.1"
+      - name: INTERFACE
+        value: "tun0"
+      - name: INTERVAL
+        value: "30"
+    volumeMounts:
+      - name: config
+        mountPath: /config
+        subPath: natmap
+```
+
+**Common Use Cases:**
+
+1. **NATMap**: Automatically update port forwarding configurations
+2. **Monitoring**: Add monitoring agents or exporters
+3. **Custom Scripts**: Run periodic maintenance or update tasks
+
+**Sharing Volumes:**
+
+Sidecars can access the same volumes as the main containers:
+- `config`: qBittorrent configuration volume
+- `downloads`: Downloads volume
+- `gluetun-config`: Gluetun configuration volume (if enabled)
+
+For the full Kubernetes container specification reference, see the [Kubernetes documentation](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#container-v1-core).
+
 ## Troubleshooting
 
 ### VPN Connection Issues

charts/qbittorrent-vpn/templates/deployment.yaml

@@ -255,7 +255,11 @@ spec:
           
           resources:
             {{- toYaml .Values.qbittorrent.resources | nindent 12 }}
-      
+
+        {{- with .Values.sidecars }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+
       volumes:
         # Create /dev/net/tun as a device
         - name: tun

charts/qbittorrent-vpn/values.yaml

@@ -225,4 +225,21 @@ extraVolumes: []
 
 # Temporary options for development/debugging
 hostNetwork: false
-initContainers: []
+initContainers: []
+
+# Additional sidecar containers
+# This allows you to add custom sidecar containers to the pod
+# Each sidecar is specified using standard Kubernetes container spec
+# Example: Add NATMap for port forwarding with VPN
+# sidecars:
+#   - name: natmap
+#     image: ghcr.io/muink/natmap:latest
+#     env:
+#       - name: GATEWAY
+#         value: "10.2.0.1"
+#       - name: INTERFACE
+#         value: "tun0"
+#     volumeMounts:
+#       - name: config
+#         mountPath: /config
+sidecars: []

charts/tandoor/Chart.yaml

@@ -0,0 +1,18 @@
+apiVersion: v2
+name: tandoor
+description: Tandoor Recipes - A recipe management application for Kubernetes
+type: application
+version: 0.0.1
+appVersion: "2.3.5"
+maintainers:
+  - name: Richard Tomik
+    email: no@m.com
+keywords:
+  - recipes
+  - cooking
+  - meal-planning
+  - tandoor
+  - food
+home: https://github.com/rtomik/helm-charts
+sources:
+  - https://github.com/TandoorRecipes/recipes

charts/tandoor/readme.md

@@ -0,0 +1,427 @@
+# Tandoor Recipes Helm Chart
+
+A Helm chart for deploying [Tandoor Recipes](https://github.com/TandoorRecipes/recipes) on Kubernetes.
+
+Tandoor is a recipe management application that allows you to manage your recipes, plan meals, and create shopping lists.
+
+Source code can be found here:
+- https://github.com/rtomik/helm-charts/tree/main/charts/tandoor
+
+## Prerequisites
+
+- Kubernetes 1.19+
+- Helm 3.0+
+- PV provisioner support in the underlying infrastructure
+- **External PostgreSQL database** (required - this chart does NOT include PostgreSQL)
+
+## Installing the Chart
+
+```bash
+helm repo add rtomik https://rtomik.github.io/helm-charts
+helm repo update
+helm install tandoor rtomik/tandoor -f values.yaml
+```
+
+## Usage Examples
+
+### Minimal Configuration
+
+```yaml
+postgresql:
+  host: "postgresql.database.svc.cluster.local"
+  database: "tandoor"
+  username: "tandoor"
+  password: "your-secure-password"
+
+config:
+  secretKey:
+    value: "your-secret-key-at-least-50-characters-long-for-security-purposes"
+```
+
+### Production Configuration
+
+```yaml
+postgresql:
+  host: "postgresql.database.svc.cluster.local"
+  database: "tandoor"
+  username: "tandoor"
+  existingSecret: "tandoor-db-secret"
+  passwordKey: "password"
+
+config:
+  secretKey:
+    existingSecret: "tandoor-app-secret"
+    secretKey: "secret-key"
+
+  allowedHosts: "tandoor.example.com"
+  csrfTrustedOrigins: "https://tandoor.example.com"
+  timezone: "Europe/Berlin"
+
+  # Optional: OpenID Connect with Authentik
+  # oidc:
+  #   enabled: true
+  #   providerId: "authentik"
+  #   providerName: "Authentik"
+  #   clientId: "your-client-id"
+  #   clientSecret: "your-client-secret"
+  #   serverUrl: "https://authentik.company/application/o/tandoor/.well-known/openid-configuration"
+
+ingress:
+  enabled: true
+  className: "nginx"
+  annotations:
+    cert-manager.io/cluster-issuer: "letsencrypt-prod"
+  hosts:
+    - host: tandoor.example.com
+      paths:
+        - path: /
+          pathType: Prefix
+  tls:
+    - hosts:
+        - tandoor.example.com
+      secretName: tandoor-tls
+
+persistence:
+  staticfiles:
+    enabled: true
+    # existingClaim: "my-existing-pvc"
+    storageClass: "longhorn"
+    size: 2Gi
+  mediafiles:
+    enabled: true
+    storageClass: "longhorn"
+    size: 10Gi
+
+resources:
+  limits:
+    cpu: 1000m
+    memory: 512Mi
+  requests:
+    cpu: 100m
+    memory: 256Mi
+```
+
+
+## Configuration
+
+All configuration options are based on the official Tandoor documentation:
+https://docs.tandoor.dev/system/configuration/
+
+The following table lists the configurable parameters and their default values.
+
+### Global Parameters
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `nameOverride` | String to partially override the release name | `""` |
+| `fullnameOverride` | String to fully override the release name | `""` |
+
+### Image Parameters
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `image.repository` | Tandoor image repository | `vabene1111/recipes` |
+| `image.tag` | Tandoor image tag | `2.3.5` |
+| `image.pullPolicy` | Tandoor image pull policy | `IfNotPresent` |
+
+### Deployment Parameters
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `replicaCount` | Number of Tandoor replicas | `1` |
+| `revisionHistoryLimit` | Number of old ReplicaSets to retain | `3` |
+
+### PostgreSQL Parameters
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `postgresql.host` | PostgreSQL host | `postgresql.default.svc.cluster.local` |
+| `postgresql.port` | PostgreSQL port | `5432` |
+| `postgresql.database` | PostgreSQL database name | `tandoor` |
+| `postgresql.username` | PostgreSQL username | `tandoor` |
+| `postgresql.password` | PostgreSQL password (not recommended for production) | `""` |
+| `postgresql.existingSecret` | Existing secret with PostgreSQL credentials | `""` |
+| `postgresql.passwordKey` | Key in existing secret for PostgreSQL password | `postgresql-password` |
+
+### Security Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.secretKey.value` | Django secret key (at least 50 characters) | `""` |
+| `config.secretKey.existingSecret` | Existing secret for Django secret key | `""` |
+| `config.secretKey.secretKey` | Key in existing secret for Django secret key | `secret-key` |
+| `config.allowedHosts` | Allowed hosts for HTTP Host Header validation | `*` |
+| `config.csrfTrustedOrigins` | CSRF trusted origins | `""` |
+| `config.corsAllowOrigins` | Enable CORS allow all origins | `false` |
+
+### Server Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.tandoorPort` | Port where Tandoor exposes its web server | `8080` |
+| `config.gunicornWorkers` | Number of Gunicorn worker processes | `3` |
+| `config.gunicornThreads` | Number of Gunicorn threads per worker | `2` |
+| `config.gunicornTimeout` | Gunicorn request timeout in seconds | `30` |
+| `config.gunicornMedia` | Enable media serving via Gunicorn | `0` |
+| `config.timezone` | Application timezone | `UTC` |
+| `config.scriptName` | URL path base for subfolder deployments | `""` |
+| `config.sessionCookieDomain` | Session cookie domain | `""` |
+| `config.sessionCookieName` | Session cookie identifier | `sessionid` |
+
+### Feature Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.enableSignup` | Allow user registration | `false` |
+| `config.enableMetrics` | Enable Prometheus metrics at /metrics | `false` |
+| `config.enablePdfExport` | Enable recipe PDF export | `false` |
+| `config.sortTreeByName` | Sort keywords/foods alphabetically | `false` |
+
+### Social Authentication
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.socialDefaultAccess` | Space ID for auto-joining new social auth users | `0` |
+| `config.socialDefaultGroup` | Default group for new users (guest/user/admin) | `guest` |
+| `config.socialProviders` | Comma-separated OAuth provider list | `""` |
+| `config.socialAccountProviders` | SOCIALACCOUNT_PROVIDERS JSON (for complex setups) | `""` |
+
+### OpenID Connect (OIDC) Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.oidc.enabled` | Enable OpenID Connect authentication | `false` |
+| `config.oidc.providerId` | Provider ID (e.g., authentik, keycloak) | `authentik` |
+| `config.oidc.providerName` | Display name on login page | `Authentik` |
+| `config.oidc.clientId` | Client ID from OIDC provider | `""` |
+| `config.oidc.clientSecret` | Client Secret from OIDC provider | `""` |
+| `config.oidc.serverUrl` | OpenID Connect well-known configuration URL | `""` |
+
+### LDAP Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.ldap.enabled` | Enable LDAP authentication | `false` |
+| `config.ldap.serverUri` | LDAP server URI | `""` |
+| `config.ldap.bindDn` | LDAP bind distinguished name | `""` |
+| `config.ldap.bindPassword` | LDAP bind password | `""` |
+| `config.ldap.userSearchBaseDn` | LDAP user search base | `""` |
+| `config.ldap.tlsCacertFile` | LDAP TLS CA certificate file | `""` |
+| `config.ldap.startTls` | Enable LDAP StartTLS | `false` |
+| `config.ldap.existingSecret` | Existing secret for LDAP credentials | `""` |
+| `config.ldap.bindPasswordKey` | Key in existing secret for LDAP password | `ldap-bind-password` |
+
+### Remote User Authentication
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.remoteUserAuth` | Enable REMOTE-USER header authentication | `false` |
+
+### Email Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.email.host` | SMTP server hostname | `""` |
+| `config.email.port` | SMTP server port | `25` |
+| `config.email.user` | SMTP authentication username | `""` |
+| `config.email.password` | SMTP authentication password | `""` |
+| `config.email.useTls` | Enable TLS for email | `false` |
+| `config.email.useSsl` | Enable SSL for email | `false` |
+| `config.email.defaultFrom` | Default from email address | `webmaster@localhost` |
+| `config.email.accountEmailSubjectPrefix` | Email subject prefix | `[Tandoor Recipes]` |
+| `config.email.existingSecret` | Existing secret for email credentials | `""` |
+| `config.email.passwordKey` | Key in existing secret for email password | `email-password` |
+
+### S3/Object Storage Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.s3.enabled` | Enable S3 storage for media files | `false` |
+| `config.s3.accessKey` | S3 access key | `""` |
+| `config.s3.secretAccessKey` | S3 secret access key | `""` |
+| `config.s3.bucketName` | S3 bucket name | `""` |
+| `config.s3.regionName` | S3 region name | `""` |
+| `config.s3.endpointUrl` | Custom S3 endpoint URL (for MinIO) | `""` |
+| `config.s3.customDomain` | CDN/proxy domain for S3 | `""` |
+| `config.s3.querystringAuth` | Use signed URLs for S3 objects | `true` |
+| `config.s3.querystringExpire` | Signed URL expiration (seconds) | `3600` |
+| `config.s3.existingSecret` | Existing secret for S3 credentials | `""` |
+
+### AI Features
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.ai.enabled` | Enable AI features | `false` |
+| `config.ai.creditsMonthly` | Monthly AI credits per space | `100` |
+| `config.ai.rateLimit` | AI API rate limit | `60/hour` |
+
+### External Services
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.fdcApiKey` | Food Data Central API key | `DEMO_KEY` |
+| `config.disableExternalConnectors` | Disable all external connectors | `false` |
+| `config.externalConnectorsQueueSize` | External connectors queue size | `100` |
+
+### Rate Limiting
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.ratelimitUrlImportRequests` | Rate limit for URL imports | `""` |
+| `config.drfThrottleRecipeUrlImport` | DRF throttle for recipe URL import | `60/hour` |
+
+### Space Defaults
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.spaceDefaultMaxRecipes` | Max recipes per space (0=unlimited) | `0` |
+| `config.spaceDefaultMaxUsers` | Max users per space (0=unlimited) | `0` |
+| `config.spaceDefaultMaxFiles` | Max file storage in MB (0=unlimited) | `0` |
+| `config.spaceDefaultAllowSharing` | Allow public recipe sharing | `true` |
+
+### User Preference Defaults
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.fractionPrefDefault` | Default fraction display | `false` |
+| `config.commentPrefDefault` | Enable comments by default | `true` |
+| `config.stickyNavPrefDefault` | Sticky navbar by default | `true` |
+| `config.maxOwnedSpacesPrefDefault` | Max spaces per user | `100` |
+
+### Cosmetic Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.unauthenticatedThemeFromSpace` | Space ID for unauthenticated theme | `0` |
+| `config.forceThemeFromSpace` | Space ID to enforce theme globally | `0` |
+
+### Performance Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.shoppingMinAutosyncInterval` | Min auto-sync interval (minutes) | `5` |
+| `config.exportFileCacheDuration` | Export cache duration (seconds) | `600` |
+
+### Legal URLs
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.termsUrl` | Terms of service URL | `""` |
+| `config.privacyUrl` | Privacy policy URL | `""` |
+| `config.imprintUrl` | Legal imprint URL | `""` |
+
+### hCaptcha Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.hcaptcha.siteKey` | hCaptcha site key | `""` |
+| `config.hcaptcha.secret` | hCaptcha secret key | `""` |
+| `config.hcaptcha.existingSecret` | Existing secret for hCaptcha | `""` |
+
+### Debugging
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `config.debug` | Enable Django debug mode | `false` |
+| `config.debugToolbar` | Enable Django Debug Toolbar | `false` |
+| `config.sqlDebug` | Enable SQL debug output | `false` |
+| `config.logLevel` | Application log level | `WARNING` |
+| `config.gunicornLogLevel` | Gunicorn log level | `info` |
+
+### Service Parameters
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `service.type` | Kubernetes Service type | `ClusterIP` |
+| `service.port` | Service HTTP port | `8080` |
+
+### Ingress Parameters
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `ingress.enabled` | Enable ingress | `false` |
+| `ingress.className` | Ingress class name | `""` |
+| `ingress.annotations` | Ingress annotations | See values.yaml |
+| `ingress.hosts` | Ingress hosts configuration | See values.yaml |
+| `ingress.tls` | Ingress TLS configuration | See values.yaml |
+
+### Persistence Parameters
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `persistence.staticfiles.enabled` | Enable static files persistence | `true` |
+| `persistence.staticfiles.existingClaim` | Use existing PVC for static files | `""` |
+| `persistence.staticfiles.storageClass` | Storage class for static files | `""` |
+| `persistence.staticfiles.accessMode` | Access mode for static files PVC | `ReadWriteOnce` |
+| `persistence.staticfiles.size` | Size of static files PVC | `1Gi` |
+| `persistence.mediafiles.enabled` | Enable media files persistence | `true` |
+| `persistence.mediafiles.existingClaim` | Use existing PVC for media files | `""` |
+| `persistence.mediafiles.storageClass` | Storage class for media files | `""` |
+| `persistence.mediafiles.accessMode` | Access mode for media files PVC | `ReadWriteOnce` |
+| `persistence.mediafiles.size` | Size of media files PVC | `5Gi` |
+
+### Pod Security Context
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `podSecurityContext.runAsNonRoot` | Run as non-root user | `true` |
+| `podSecurityContext.runAsUser` | User ID to run as | `1000` |
+| `podSecurityContext.fsGroup` | Group ID for filesystem | `1000` |
+
+### Container Security Context
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `containerSecurityContext.allowPrivilegeEscalation` | Allow privilege escalation | `false` |
+| `containerSecurityContext.readOnlyRootFilesystem` | Read-only root filesystem | `false` |
+
+### Autoscaling Parameters
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `autoscaling.enabled` | Enable autoscaling | `false` |
+| `autoscaling.minReplicas` | Minimum replicas | `1` |
+| `autoscaling.maxReplicas` | Maximum replicas | `3` |
+| `autoscaling.targetCPUUtilizationPercentage` | Target CPU utilization | `80` |
+| `autoscaling.targetMemoryUtilizationPercentage` | Target memory utilization | `80` |
+
+### Probes Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `probes.liveness.enabled` | Enable liveness probe | `true` |
+| `probes.liveness.initialDelaySeconds` | Initial delay for liveness probe | `30` |
+| `probes.liveness.periodSeconds` | Period for liveness probe | `10` |
+| `probes.readiness.enabled` | Enable readiness probe | `true` |
+| `probes.readiness.initialDelaySeconds` | Initial delay for readiness probe | `15` |
+| `probes.readiness.periodSeconds` | Period for readiness probe | `5` |
+
+### Additional Configuration
+
+| Name | Description | Value |
+|------|-------------|-------|
+| `env` | Additional environment variables | `[]` |
+| `extraEnvFrom` | Additional environment variables from secrets | `[]` |
+| `extraVolumes` | Additional volumes | `[]` |
+| `extraVolumeMounts` | Additional volume mounts | `[]` |
+| `nodeSelector` | Node selector | `{}` |
+| `tolerations` | Tolerations | `[]` |
+| `affinity` | Affinity rules | `{}` |
+
+## Uninstalling the Chart
+
+```bash
+helm uninstall tandoor
+```
+
+**Note:** PVCs are not automatically deleted. To remove them:
+
+```bash
+kubectl delete pvc -l app.kubernetes.io/name=tandoor
+```
+
+## Links
+
+- [Tandoor Recipes GitHub](https://github.com/TandoorRecipes/recipes)
+- [Tandoor Documentation](https://docs.tandoor.dev/)
+- [Configuration Reference](https://docs.tandoor.dev/system/configuration/)

charts/tandoor/templates/NOTES.txt

@@ -0,0 +1,43 @@
+Tandoor Recipes has been deployed successfully!
+
+{{- if .Values.ingress.enabled }}
+
+Access Tandoor at:
+{{- range $host := .Values.ingress.hosts }}
+  {{- range .paths }}
+  http{{ if $.Values.ingress.tls }}s{{ end }}://{{ $host.host }}{{ .path }}
+  {{- end }}
+{{- end }}
+
+{{- else if contains "NodePort" .Values.service.type }}
+
+Get the application URL by running:
+  export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "tandoor.fullname" . }})
+  export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
+  echo http://$NODE_IP:$NODE_PORT
+
+{{- else if contains "LoadBalancer" .Values.service.type }}
+
+Get the application URL by running:
+  NOTE: It may take a few minutes for the LoadBalancer IP to be available.
+  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "tandoor.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
+  echo http://$SERVICE_IP:{{ .Values.service.port }}
+
+{{- else if contains "ClusterIP" .Values.service.type }}
+
+Access Tandoor by port-forwarding:
+  kubectl --namespace {{ .Release.Namespace }} port-forward service/{{ include "tandoor.fullname" . }} 8080:{{ .Values.service.port }}
+
+Then visit: http://localhost:8080
+
+{{- end }}
+
+IMPORTANT: This chart requires an external PostgreSQL database.
+Make sure your PostgreSQL database is configured and accessible at:
+  Host: {{ .Values.postgresql.host }}
+  Port: {{ .Values.postgresql.port }}
+  Database: {{ .Values.postgresql.database }}
+
+For more information, visit:
+  - Tandoor Documentation: https://docs.tandoor.dev/
+  - Configuration Reference: https://docs.tandoor.dev/system/configuration/

charts/tandoor/templates/_helpers.tpl

@@ -0,0 +1,59 @@
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "tandoor.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Create a default fully qualified app name.
+*/}}
+{{- define "tandoor.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- printf "%s" $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "tandoor.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Common labels
+*/}}
+{{- define "tandoor.labels" -}}
+helm.sh/chart: {{ include "tandoor.chart" . }}
+{{ include "tandoor.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{/*
+Selector labels
+*/}}
+{{- define "tandoor.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "tandoor.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+
+{{/*
+PostgreSQL host
+*/}}
+{{- define "tandoor.postgresql.host" -}}
+{{- .Values.postgresql.host }}
+{{- end }}
+
+{{/*
+PostgreSQL port
+*/}}
+{{- define "tandoor.postgresql.port" -}}
+{{- .Values.postgresql.port | toString }}
+{{- end }}

charts/tandoor/templates/deployment.yaml

@@ -0,0 +1,402 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "tandoor.fullname" . }}
+  labels:
+    {{- include "tandoor.labels" . | nindent 4 }}
+  annotations:
+    checksum/secret: {{ include (print $.Template.BasePath "/secret.yaml") . | sha256sum }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  revisionHistoryLimit: {{ .Values.revisionHistoryLimit }}
+  selector:
+    matchLabels:
+      {{- include "tandoor.selectorLabels" . | nindent 6 }}
+  strategy:
+    type: RollingUpdate
+    rollingUpdate:
+      maxUnavailable: 1
+      maxSurge: 1
+  template:
+    metadata:
+      labels:
+        {{- include "tandoor.selectorLabels" . | nindent 8 }}
+      annotations:
+        {{- with .Values.podAnnotations }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+    spec:
+      {{- with .Values.imagePullSecrets }}
+      imagePullSecrets:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      securityContext:
+        {{- toYaml .Values.podSecurityContext | nindent 8 }}
+      containers:
+        - name: {{ .Chart.Name }}
+          securityContext:
+            {{- toYaml .Values.containerSecurityContext | nindent 12 }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default .Chart.AppVersion }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: {{ .Values.config.tandoorPort }}
+              protocol: TCP
+          {{- if .Values.probes.liveness.enabled }}
+          livenessProbe:
+            httpGet:
+              path: {{ .Values.probes.liveness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.liveness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.liveness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.liveness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.liveness.failureThreshold }}
+            successThreshold: {{ .Values.probes.liveness.successThreshold }}
+          {{- end }}
+          {{- if .Values.probes.readiness.enabled }}
+          readinessProbe:
+            httpGet:
+              path: {{ .Values.probes.readiness.path }}
+              port: http
+            initialDelaySeconds: {{ .Values.probes.readiness.initialDelaySeconds }}
+            periodSeconds: {{ .Values.probes.readiness.periodSeconds }}
+            timeoutSeconds: {{ .Values.probes.readiness.timeoutSeconds }}
+            failureThreshold: {{ .Values.probes.readiness.failureThreshold }}
+            successThreshold: {{ .Values.probes.readiness.successThreshold }}
+          {{- end }}
+          env:
+            # Database configuration
+            - name: DB_ENGINE
+              value: "django.db.backends.postgresql"
+            - name: POSTGRES_HOST
+              value: {{ include "tandoor.postgresql.host" . | quote }}
+            - name: POSTGRES_PORT
+              value: {{ include "tandoor.postgresql.port" . | quote }}
+            - name: POSTGRES_DB
+              value: {{ .Values.postgresql.database | quote }}
+            - name: POSTGRES_USER
+              value: {{ .Values.postgresql.username | quote }}
+            - name: POSTGRES_PASSWORD
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.postgresql.existingSecret | default (printf "%s-secrets" (include "tandoor.fullname" .)) }}
+                  key: {{ .Values.postgresql.passwordKey | default "postgresql-password" }}
+
+            # Security
+            - name: SECRET_KEY
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.config.secretKey.existingSecret | default (printf "%s-secrets" (include "tandoor.fullname" .)) }}
+                  key: {{ .Values.config.secretKey.secretKey | default "secret-key" }}
+            - name: ALLOWED_HOSTS
+              value: {{ .Values.config.allowedHosts | quote }}
+            {{- if .Values.config.csrfTrustedOrigins }}
+            - name: CSRF_TRUSTED_ORIGINS
+              value: {{ .Values.config.csrfTrustedOrigins | quote }}
+            {{- end }}
+            - name: CORS_ALLOW_ALL_ORIGINS
+              value: {{ ternary "1" "0" .Values.config.corsAllowOrigins | quote }}
+
+            # Server configuration
+            - name: TANDOOR_PORT
+              value: {{ .Values.config.tandoorPort | quote }}
+            - name: GUNICORN_WORKERS
+              value: {{ .Values.config.gunicornWorkers | quote }}
+            - name: GUNICORN_THREADS
+              value: {{ .Values.config.gunicornThreads | quote }}
+            - name: GUNICORN_TIMEOUT
+              value: {{ .Values.config.gunicornTimeout | quote }}
+            - name: GUNICORN_MEDIA
+              value: {{ .Values.config.gunicornMedia | quote }}
+
+            # URL configuration
+            {{- if .Values.config.scriptName }}
+            - name: SCRIPT_NAME
+              value: {{ .Values.config.scriptName | quote }}
+            {{- end }}
+
+            # Session cookie configuration
+            {{- if .Values.config.sessionCookieDomain }}
+            - name: SESSION_COOKIE_DOMAIN
+              value: {{ .Values.config.sessionCookieDomain | quote }}
+            {{- end }}
+            - name: SESSION_COOKIE_NAME
+              value: {{ .Values.config.sessionCookieName | quote }}
+
+            # Time and locale
+            - name: TZ
+              value: {{ .Values.config.timezone | quote }}
+
+            # Feature toggles
+            - name: ENABLE_SIGNUP
+              value: {{ ternary "1" "0" .Values.config.enableSignup | quote }}
+            - name: ENABLE_METRICS
+              value: {{ ternary "1" "0" .Values.config.enableMetrics | quote }}
+            - name: ENABLE_PDF_EXPORT
+              value: {{ ternary "1" "0" .Values.config.enablePdfExport | quote }}
+            - name: SORT_TREE_BY_NAME
+              value: {{ ternary "1" "0" .Values.config.sortTreeByName | quote }}
+
+            # Social authentication
+            - name: SOCIAL_DEFAULT_ACCESS
+              value: {{ .Values.config.socialDefaultAccess | quote }}
+            - name: SOCIAL_DEFAULT_GROUP
+              value: {{ .Values.config.socialDefaultGroup | quote }}
+            {{- if or .Values.config.socialProviders .Values.config.oidc.enabled }}
+            - name: SOCIAL_PROVIDERS
+              value: {{ .Values.config.socialProviders | default "allauth.socialaccount.providers.openid_connect" | quote }}
+            {{- end }}
+            {{- if .Values.config.socialAccountProviders }}
+            - name: SOCIALACCOUNT_PROVIDERS
+              value: {{ .Values.config.socialAccountProviders | quote }}
+            {{- end }}
+
+            # OpenID Connect / OAuth configuration (e.g., Authentik, Keycloak)
+            # Note: For production, consider using extraEnvFrom with a secret containing SOCIALACCOUNT_PROVIDERS
+            {{- if .Values.config.oidc.enabled }}
+            {{- $clientId := .Values.config.oidc.clientId }}
+            {{- $clientSecret := .Values.config.oidc.clientSecret }}
+            - name: SOCIALACCOUNT_PROVIDERS
+              value: '{"openid_connect":{"APPS":[{"provider_id":"{{ .Values.config.oidc.providerId }}","name":"{{ .Values.config.oidc.providerName }}","client_id":"{{ $clientId }}","secret":"{{ $clientSecret }}","settings":{"server_url":"{{ .Values.config.oidc.serverUrl }}"}}]}}'
+            {{- end }}
+
+            # Remote user authentication
+            - name: REMOTE_USER_AUTH
+              value: {{ ternary "1" "0" .Values.config.remoteUserAuth | quote }}
+
+            # LDAP configuration
+            {{- if .Values.config.ldap.enabled }}
+            - name: LDAP_AUTH
+              value: "1"
+            - name: AUTH_LDAP_SERVER_URI
+              value: {{ .Values.config.ldap.serverUri | quote }}
+            {{- if .Values.config.ldap.bindDn }}
+            - name: AUTH_LDAP_BIND_DN
+              value: {{ .Values.config.ldap.bindDn | quote }}
+            {{- end }}
+            {{- if or .Values.config.ldap.bindPassword .Values.config.ldap.existingSecret }}
+            - name: AUTH_LDAP_BIND_PASSWORD
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.config.ldap.existingSecret | default (printf "%s-secrets" (include "tandoor.fullname" .)) }}
+                  key: {{ .Values.config.ldap.bindPasswordKey | default "ldap-bind-password" }}
+            {{- end }}
+            {{- if .Values.config.ldap.userSearchBaseDn }}
+            - name: AUTH_LDAP_USER_SEARCH_BASE_DN
+              value: {{ .Values.config.ldap.userSearchBaseDn | quote }}
+            {{- end }}
+            {{- if .Values.config.ldap.tlsCacertFile }}
+            - name: AUTH_LDAP_TLS_CACERTFILE
+              value: {{ .Values.config.ldap.tlsCacertFile | quote }}
+            {{- end }}
+            {{- if .Values.config.ldap.startTls }}
+            - name: AUTH_LDAP_START_TLS
+              value: "True"
+            {{- end }}
+            {{- end }}
+
+            # Email configuration
+            {{- if .Values.config.email.host }}
+            - name: EMAIL_HOST
+              value: {{ .Values.config.email.host | quote }}
+            - name: EMAIL_PORT
+              value: {{ .Values.config.email.port | quote }}
+            {{- if .Values.config.email.user }}
+            - name: EMAIL_HOST_USER
+              value: {{ .Values.config.email.user | quote }}
+            - name: EMAIL_HOST_PASSWORD
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.config.email.existingSecret | default (printf "%s-secrets" (include "tandoor.fullname" .)) }}
+                  key: {{ .Values.config.email.passwordKey | default "email-password" }}
+            {{- end }}
+            - name: EMAIL_USE_TLS
+              value: {{ ternary "1" "0" .Values.config.email.useTls | quote }}
+            - name: EMAIL_USE_SSL
+              value: {{ ternary "1" "0" .Values.config.email.useSsl | quote }}
+            - name: DEFAULT_FROM_EMAIL
+              value: {{ .Values.config.email.defaultFrom | quote }}
+            - name: ACCOUNT_EMAIL_SUBJECT_PREFIX
+              value: {{ .Values.config.email.accountEmailSubjectPrefix | quote }}
+            {{- end }}
+
+            # S3/Object storage configuration
+            {{- if .Values.config.s3.enabled }}
+            - name: S3_ACCESS_KEY
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.config.s3.existingSecret | default (printf "%s-secrets" (include "tandoor.fullname" .)) }}
+                  key: {{ .Values.config.s3.accessKeyKey | default "s3-access-key" }}
+            - name: S3_SECRET_ACCESS_KEY
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.config.s3.existingSecret | default (printf "%s-secrets" (include "tandoor.fullname" .)) }}
+                  key: {{ .Values.config.s3.secretAccessKeyKey | default "s3-secret-access-key" }}
+            - name: S3_BUCKET_NAME
+              value: {{ .Values.config.s3.bucketName | quote }}
+            {{- if .Values.config.s3.regionName }}
+            - name: S3_REGION_NAME
+              value: {{ .Values.config.s3.regionName | quote }}
+            {{- end }}
+            {{- if .Values.config.s3.endpointUrl }}
+            - name: S3_ENDPOINT_URL
+              value: {{ .Values.config.s3.endpointUrl | quote }}
+            {{- end }}
+            {{- if .Values.config.s3.customDomain }}
+            - name: S3_CUSTOM_DOMAIN
+              value: {{ .Values.config.s3.customDomain | quote }}
+            {{- end }}
+            - name: S3_QUERYSTRING_AUTH
+              value: {{ ternary "1" "0" .Values.config.s3.querystringAuth | quote }}
+            - name: S3_QUERYSTRING_EXPIRE
+              value: {{ .Values.config.s3.querystringExpire | quote }}
+            {{- end }}
+
+            # AI features
+            {{- if .Values.config.ai.enabled }}
+            - name: SPACE_AI_ENABLED
+              value: "1"
+            - name: SPACE_AI_CREDITS_MONTHLY
+              value: {{ .Values.config.ai.creditsMonthly | quote }}
+            - name: AI_RATELIMIT
+              value: {{ .Values.config.ai.rateLimit | quote }}
+            {{- end }}
+
+            # Food Data Central API
+            - name: FDC_API_KEY
+              value: {{ .Values.config.fdcApiKey | quote }}
+
+            # External connectors
+            - name: DISABLE_EXTERNAL_CONNECTORS
+              value: {{ ternary "1" "0" .Values.config.disableExternalConnectors | quote }}
+            - name: EXTERNAL_CONNECTORS_QUEUE_SIZE
+              value: {{ .Values.config.externalConnectorsQueueSize | quote }}
+
+            # Rate limiting
+            {{- if .Values.config.ratelimitUrlImportRequests }}
+            - name: RATELIMIT_URL_IMPORT_REQUESTS
+              value: {{ .Values.config.ratelimitUrlImportRequests | quote }}
+            {{- end }}
+            - name: DRF_THROTTLE_RECIPE_URL_IMPORT
+              value: {{ .Values.config.drfThrottleRecipeUrlImport | quote }}
+
+            # Space defaults
+            - name: SPACE_DEFAULT_MAX_RECIPES
+              value: {{ .Values.config.spaceDefaultMaxRecipes | quote }}
+            - name: SPACE_DEFAULT_MAX_USERS
+              value: {{ .Values.config.spaceDefaultMaxUsers | quote }}
+            - name: SPACE_DEFAULT_MAX_FILES
+              value: {{ .Values.config.spaceDefaultMaxFiles | quote }}
+            - name: SPACE_DEFAULT_ALLOW_SHARING
+              value: {{ ternary "1" "0" .Values.config.spaceDefaultAllowSharing | quote }}
+
+            # User preference defaults
+            - name: FRACTION_PREF_DEFAULT
+              value: {{ ternary "1" "0" .Values.config.fractionPrefDefault | quote }}
+            - name: COMMENT_PREF_DEFAULT
+              value: {{ ternary "1" "0" .Values.config.commentPrefDefault | quote }}
+            - name: STICKY_NAV_PREF_DEFAULT
+              value: {{ ternary "1" "0" .Values.config.stickyNavPrefDefault | quote }}
+            - name: MAX_OWNED_SPACES_PREF_DEFAULT
+              value: {{ .Values.config.maxOwnedSpacesPrefDefault | quote }}
+
+            # Cosmetic
+            - name: UNAUTHENTICATED_THEME_FROM_SPACE
+              value: {{ .Values.config.unauthenticatedThemeFromSpace | quote }}
+            - name: FORCE_THEME_FROM_SPACE
+              value: {{ .Values.config.forceThemeFromSpace | quote }}
+
+            # Performance
+            - name: SHOPPING_MIN_AUTOSYNC_INTERVAL
+              value: {{ .Values.config.shoppingMinAutosyncInterval | quote }}
+            - name: EXPORT_FILE_CACHE_DURATION
+              value: {{ .Values.config.exportFileCacheDuration | quote }}
+
+            # Legal URLs
+            {{- if .Values.config.termsUrl }}
+            - name: TERMS_URL
+              value: {{ .Values.config.termsUrl | quote }}
+            {{- end }}
+            {{- if .Values.config.privacyUrl }}
+            - name: PRIVACY_URL
+              value: {{ .Values.config.privacyUrl | quote }}
+            {{- end }}
+            {{- if .Values.config.imprintUrl }}
+            - name: IMPRINT_URL
+              value: {{ .Values.config.imprintUrl | quote }}
+            {{- end }}
+
+            # hCaptcha
+            {{- if .Values.config.hcaptcha.siteKey }}
+            - name: HCAPTCHA_SITEKEY
+              value: {{ .Values.config.hcaptcha.siteKey | quote }}
+            - name: HCAPTCHA_SECRET
+              valueFrom:
+                secretKeyRef:
+                  name: {{ .Values.config.hcaptcha.existingSecret | default (printf "%s-secrets" (include "tandoor.fullname" .)) }}
+                  key: {{ .Values.config.hcaptcha.secretKeyKey | default "hcaptcha-secret" }}
+            {{- end }}
+
+            # Debugging
+            - name: DEBUG
+              value: {{ ternary "1" "0" .Values.config.debug | quote }}
+            - name: DEBUG_TOOLBAR
+              value: {{ ternary "1" "0" .Values.config.debugToolbar | quote }}
+            - name: SQL_DEBUG
+              value: {{ ternary "1" "0" .Values.config.sqlDebug | quote }}
+            - name: LOG_LEVEL
+              value: {{ .Values.config.logLevel | quote }}
+            - name: GUNICORN_LOG_LEVEL
+              value: {{ .Values.config.gunicornLogLevel | quote }}
+
+            # Custom environment variables
+            {{- range .Values.env }}
+            - name: {{ .name }}
+              value: {{ .value | quote }}
+            {{- end }}
+          {{- with .Values.extraEnvFrom }}
+          envFrom:
+            {{- toYaml . | nindent 12 }}
+          {{- end }}
+          volumeMounts:
+            - name: staticfiles
+              mountPath: /opt/recipes/staticfiles
+            - name: mediafiles
+              mountPath: /opt/recipes/mediafiles
+            {{- with .Values.extraVolumeMounts }}
+            {{- toYaml . | nindent 12 }}
+            {{- end }}
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+      volumes:
+        {{- if .Values.persistence.staticfiles.enabled }}
+        - name: staticfiles
+          persistentVolumeClaim:
+            claimName: {{ .Values.persistence.staticfiles.existingClaim | default (printf "%s-staticfiles" (include "tandoor.fullname" .)) }}
+        {{- else }}
+        - name: staticfiles
+          emptyDir: {}
+        {{- end }}
+        {{- if .Values.persistence.mediafiles.enabled }}
+        - name: mediafiles
+          persistentVolumeClaim:
+            claimName: {{ .Values.persistence.mediafiles.existingClaim | default (printf "%s-mediafiles" (include "tandoor.fullname" .)) }}
+        {{- else }}
+        - name: mediafiles
+          emptyDir: {}
+        {{- end }}
+        {{- with .Values.extraVolumes }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+      {{- with .Values.nodeSelector }}
+      nodeSelector:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.affinity }}
+      affinity:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.tolerations }}
+      tolerations:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}

charts/tandoor/templates/ingress.yaml

@@ -0,0 +1,43 @@
+{{- if .Values.ingress.enabled -}}
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: {{ include "tandoor.fullname" . }}
+  labels:
+    {{- include "tandoor.labels" . | nindent 4 }}
+  {{- with .Values.ingress.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  {{- if .Values.ingress.className }}
+  ingressClassName: {{ .Values.ingress.className }}
+  {{- end }}
+  {{- if .Values.ingress.tls }}
+  tls:
+    {{- range .Values.ingress.tls }}
+    - hosts:
+        {{- range .hosts }}
+        - {{ . | quote }}
+        {{- end }}
+      {{- if .secretName }}
+      secretName: {{ .secretName }}
+      {{- end }}
+    {{- end }}
+  {{- end }}
+  rules:
+    {{- range .Values.ingress.hosts }}
+    - host: {{ .host | quote }}
+      http:
+        paths:
+          {{- range .paths }}
+          - path: {{ .path }}
+            pathType: {{ .pathType }}
+            backend:
+              service:
+                name: {{ include "tandoor.fullname" $ }}
+                port:
+                  number: {{ $.Values.service.port }}
+          {{- end }}
+    {{- end }}
+{{- end }}

charts/tandoor/templates/pvc.yaml

@@ -0,0 +1,44 @@
+{{- if and .Values.persistence.staticfiles.enabled (not .Values.persistence.staticfiles.existingClaim) }}
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: {{ include "tandoor.fullname" . }}-staticfiles
+  labels:
+    {{- include "tandoor.labels" . | nindent 4 }}
+  {{- with .Values.persistence.staticfiles.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  accessModes:
+    - {{ .Values.persistence.staticfiles.accessMode | quote }}
+  {{- if .Values.persistence.staticfiles.storageClass }}
+  storageClassName: {{ .Values.persistence.staticfiles.storageClass | quote }}
+  {{- end }}
+  resources:
+    requests:
+      storage: {{ .Values.persistence.staticfiles.size | quote }}
+---
+{{- end }}
+
+{{- if and .Values.persistence.mediafiles.enabled (not .Values.persistence.mediafiles.existingClaim) }}
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: {{ include "tandoor.fullname" . }}-mediafiles
+  labels:
+    {{- include "tandoor.labels" . | nindent 4 }}
+  {{- with .Values.persistence.mediafiles.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+  accessModes:
+    - {{ .Values.persistence.mediafiles.accessMode | quote }}
+  {{- if .Values.persistence.mediafiles.storageClass }}
+  storageClassName: {{ .Values.persistence.mediafiles.storageClass | quote }}
+  {{- end }}
+  resources:
+    requests:
+      storage: {{ .Values.persistence.mediafiles.size | quote }}
+{{- end }}

charts/tandoor/templates/secret.yaml

@@ -0,0 +1,49 @@
+{{- $needsSecret := false -}}
+{{- if not .Values.config.secretKey.existingSecret -}}
+  {{- $needsSecret = true -}}
+{{- end -}}
+{{- if not .Values.postgresql.existingSecret -}}
+  {{- $needsSecret = true -}}
+{{- end -}}
+{{- if and .Values.config.ldap.enabled .Values.config.ldap.bindPassword (not .Values.config.ldap.existingSecret) -}}
+  {{- $needsSecret = true -}}
+{{- end -}}
+{{- if and .Values.config.email.host .Values.config.email.user (not .Values.config.email.existingSecret) -}}
+  {{- $needsSecret = true -}}
+{{- end -}}
+{{- if and .Values.config.s3.enabled (not .Values.config.s3.existingSecret) -}}
+  {{- $needsSecret = true -}}
+{{- end -}}
+{{- if and .Values.config.hcaptcha.siteKey .Values.config.hcaptcha.secret (not .Values.config.hcaptcha.existingSecret) -}}
+  {{- $needsSecret = true -}}
+{{- end -}}
+
+{{- if $needsSecret }}
+apiVersion: v1
+kind: Secret
+metadata:
+  name: {{ include "tandoor.fullname" . }}-secrets
+  labels:
+    {{- include "tandoor.labels" . | nindent 4 }}
+type: Opaque
+data:
+  {{- if not .Values.config.secretKey.existingSecret }}
+  {{ .Values.config.secretKey.secretKey | default "secret-key" }}: {{ .Values.config.secretKey.value | default "change-me-tandoor-secret-key-at-least-50-characters-long-for-security" | b64enc }}
+  {{- end }}
+  {{- if not .Values.postgresql.existingSecret }}
+  {{ .Values.postgresql.passwordKey | default "postgresql-password" }}: {{ .Values.postgresql.password | default "tandoor" | b64enc }}
+  {{- end }}
+  {{- if and .Values.config.ldap.enabled .Values.config.ldap.bindPassword (not .Values.config.ldap.existingSecret) }}
+  {{ .Values.config.ldap.bindPasswordKey | default "ldap-bind-password" }}: {{ .Values.config.ldap.bindPassword | b64enc }}
+  {{- end }}
+  {{- if and .Values.config.email.host .Values.config.email.user (not .Values.config.email.existingSecret) }}
+  {{ .Values.config.email.passwordKey | default "email-password" }}: {{ .Values.config.email.password | default "" | b64enc }}
+  {{- end }}
+  {{- if and .Values.config.s3.enabled (not .Values.config.s3.existingSecret) }}
+  {{ .Values.config.s3.accessKeyKey | default "s3-access-key" }}: {{ .Values.config.s3.accessKey | default "" | b64enc }}
+  {{ .Values.config.s3.secretAccessKeyKey | default "s3-secret-access-key" }}: {{ .Values.config.s3.secretAccessKey | default "" | b64enc }}
+  {{- end }}
+  {{- if and .Values.config.hcaptcha.siteKey .Values.config.hcaptcha.secret (not .Values.config.hcaptcha.existingSecret) }}
+  {{ .Values.config.hcaptcha.secretKeyKey | default "hcaptcha-secret" }}: {{ .Values.config.hcaptcha.secret | b64enc }}
+  {{- end }}
+{{- end }}

charts/tandoor/templates/service.yaml

@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "tandoor.fullname" . }}
+  labels:
+    {{- include "tandoor.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  ports:
+    - port: {{ .Values.service.port }}
+      targetPort: http
+      protocol: TCP
+      name: http
+  selector:
+    {{- include "tandoor.selectorLabels" . | nindent 4 }}

charts/tandoor/values.yaml

@@ -0,0 +1,317 @@
+## Global settings
+nameOverride: ""
+fullnameOverride: ""
+
+## Image settings
+image:
+  repository: vabene1111/recipes
+  tag: "2.3.5"
+  pullPolicy: IfNotPresent
+
+## Deployment settings
+replicaCount: 1
+revisionHistoryLimit: 3
+
+# Pod security settings
+# Note: Tandoor runs nginx internally which requires root privileges
+# to write to /var/lib/nginx, /run/nginx, and /opt/recipes/http.d
+podSecurityContext:
+  fsGroup: 0
+
+containerSecurityContext:
+  runAsUser: 0
+  runAsGroup: 0
+  allowPrivilegeEscalation: false
+  readOnlyRootFilesystem: false
+
+## Pod scheduling
+nodeSelector: {}
+tolerations: []
+affinity: {}
+
+## Service settings
+service:
+  type: ClusterIP
+  port: 8080
+
+## Ingress settings
+ingress:
+  enabled: false
+  className: ""
+  annotations:
+    traefik.ingress.kubernetes.io/router.entrypoints: websecure
+    # Enable these for proper HTTP to HTTPS redirect (prevents Origin: null issues)
+    # traefik.ingress.kubernetes.io/router.middlewares: default-redirect-https@kubernetescrd
+  hosts:
+    - host: tandoor.domain.com
+      paths:
+        - path: /
+          pathType: Prefix
+  tls:
+    - hosts:
+        - tandoor.domain.com
+      # Optional: specify the name of an existing TLS secret
+      # secretName: "existing-tls-secret"
+
+## Persistence settings
+persistence:
+  # Tandoor static files directory
+  staticfiles:
+    enabled: true
+    # Use an existing PVC instead of creating a new one
+    existingClaim: ""
+    storageClass: ""
+    accessMode: ReadWriteOnce
+    size: 1Gi
+    annotations: {}
+  # Tandoor media files directory (recipe images, etc.)
+  mediafiles:
+    enabled: true
+    # Use an existing PVC instead of creating a new one
+    existingClaim: ""
+    storageClass: ""
+    accessMode: ReadWriteOnce
+    size: 5Gi
+    annotations: {}
+
+# Extra volume mounts
+extraVolumeMounts: []
+
+# Extra volumes
+extraVolumes: []
+
+## Resource limits and requests
+# resources:
+#   limits:
+#     cpu: 1000m
+#     memory: 512Mi
+#   requests:
+#     cpu: 100m
+#     memory: 256Mi
+
+## Application health checks
+probes:
+  liveness:
+    enabled: true
+    initialDelaySeconds: 30
+    periodSeconds: 10
+    timeoutSeconds: 5
+    failureThreshold: 6
+    successThreshold: 1
+    path: /
+  readiness:
+    enabled: true
+    initialDelaySeconds: 15
+    periodSeconds: 5
+    timeoutSeconds: 3
+    failureThreshold: 3
+    successThreshold: 1
+    path: /
+
+## Autoscaling configuration
+autoscaling:
+  enabled: false
+  minReplicas: 1
+  maxReplicas: 3
+  targetCPUUtilizationPercentage: 80
+  targetMemoryUtilizationPercentage: 80
+
+## External PostgreSQL database configuration
+## This chart does NOT include PostgreSQL - you must provide an external database
+postgresql:
+  host: "postgresql.default.svc.cluster.local"
+  port: 5432
+  database: "tandoor"
+  username: "tandoor"
+  # Use existingSecret for credentials (recommended for production)
+  existingSecret: ""
+  passwordKey: "postgresql-password"
+  # Or set password directly (not recommended for production)
+  password: ""
+
+## Tandoor Configuration
+## All settings based on official documentation: https://docs.tandoor.dev/system/configuration/
+config:
+  # Required: Secret key for Django cryptographic operations (at least 50 characters)
+  secretKey:
+    # Use existingSecret for production
+    existingSecret: ""
+    secretKey: "secret-key"
+    # Or set directly (not recommended for production)
+    value: ""
+
+  # Security setting to prevent HTTP Host Header Attacks
+  allowedHosts: "*"
+
+  # Allows setting origins to allow for unsafe requests (CSRF)
+  csrfTrustedOrigins: ""
+
+  # Enable cross-origin resource sharing
+  corsAllowOrigins: false
+
+  # Time and locale settings
+  timezone: "UTC"
+
+  # Server configuration
+  tandoorPort: 8080
+  gunicornWorkers: 3
+  gunicornThreads: 2
+  gunicornTimeout: 30
+  gunicornMedia: 0
+
+  # URL configuration (for reverse proxy setups)
+  # URL path base for subfolder deployments
+  scriptName: ""
+
+  # Session cookie configuration
+  sessionCookieDomain: ""
+  sessionCookieName: "sessionid"
+
+  # Feature toggles
+  enableSignup: false
+  enableMetrics: false
+  enablePdfExport: false
+  sortTreeByName: false
+
+  # Social authentication
+  socialDefaultAccess: 0
+  socialDefaultGroup: "guest"
+  socialProviders: ""
+  # For OpenID Connect providers (like Authentik), use the socialAccountProviders field
+  # or set via env for complex JSON configurations
+  socialAccountProviders: ""
+
+  # OpenID Connect / OAuth configuration (e.g., Authentik, Keycloak, etc.)
+  # For simple single-provider OIDC setup, configure here.
+  # For complex multi-provider setups or production with secrets, use env + extraEnvFrom.
+  oidc:
+    enabled: false
+    # Provider ID (e.g., "authentik", "keycloak")
+    providerId: "authentik"
+    # Display name shown on login page
+    providerName: "Authentik"
+    # Client ID from your OIDC provider
+    clientId: ""
+    # Client Secret from your OIDC provider (for production, use extraEnvFrom with a secret)
+    clientSecret: ""
+    # OpenID Connect well-known configuration URL
+    # e.g., https://authentik.company/application/o/<application_slug>/.well-known/openid-configuration
+    serverUrl: ""
+
+  # Remote user authentication
+  remoteUserAuth: false
+
+  # LDAP authentication (optional)
+  ldap:
+    enabled: false
+    serverUri: ""
+    bindDn: ""
+    bindPassword: ""
+    bindPasswordFile: ""
+    userSearchBaseDn: ""
+    tlsCacertFile: ""
+    startTls: false
+    existingSecret: ""
+    bindPasswordKey: "ldap-bind-password"
+
+  # Email configuration (optional)
+  email:
+    host: ""
+    port: 25
+    user: ""
+    password: ""
+    useTls: false
+    useSsl: false
+    defaultFrom: "webmaster@localhost"
+    accountEmailSubjectPrefix: "[Tandoor Recipes]"
+    existingSecret: ""
+    passwordKey: "email-password"
+
+  # S3/Object storage configuration (optional)
+  s3:
+    enabled: false
+    accessKey: ""
+    secretAccessKey: ""
+    bucketName: ""
+    regionName: ""
+    endpointUrl: ""
+    customDomain: ""
+    querystringAuth: true
+    querystringExpire: 3600
+    existingSecret: ""
+    accessKeyKey: "s3-access-key"
+    secretAccessKeyKey: "s3-secret-access-key"
+
+  # AI features (optional)
+  ai:
+    enabled: false
+    creditsMonthly: 100
+    rateLimit: "60/hour"
+
+  # Food Data Central API key for nutrition data
+  fdcApiKey: "DEMO_KEY"
+
+  # External connectors
+  disableExternalConnectors: false
+  externalConnectorsQueueSize: 100
+
+  # Rate limiting
+  ratelimitUrlImportRequests: ""
+  drfThrottleRecipeUrlImport: "60/hour"
+
+  # Space defaults
+  spaceDefaultMaxRecipes: 0
+  spaceDefaultMaxUsers: 0
+  spaceDefaultMaxFiles: 0
+  spaceDefaultAllowSharing: true
+
+  # User preference defaults
+  fractionPrefDefault: false
+  commentPrefDefault: true
+  stickyNavPrefDefault: true
+  maxOwnedSpacesPrefDefault: 100
+
+  # Cosmetic
+  unauthenticatedThemeFromSpace: 0
+  forceThemeFromSpace: 0
+
+  # Performance
+  shoppingMinAutosyncInterval: 5
+  exportFileCacheDuration: 600
+
+  # Legal URLs (optional)
+  termsUrl: ""
+  privacyUrl: ""
+  imprintUrl: ""
+
+  # hCaptcha (optional)
+  hcaptcha:
+    siteKey: ""
+    secret: ""
+    existingSecret: ""
+    secretKeyKey: "hcaptcha-secret"
+
+  # Debugging (not recommended for production)
+  debug: false
+  debugToolbar: false
+  sqlDebug: false
+  logLevel: "WARNING"
+  gunicornLogLevel: "info"
+
+# Environment variables (for additional configuration not covered above)
+# Use this for advanced configurations or settings not exposed in config section
+env: []
+  # Example: Custom environment variable
+  # - name: CUSTOM_VAR
+  #   value: "custom-value"
+  #
+  # Example: Complex SOCIALACCOUNT_PROVIDERS for multiple OIDC providers
+  # - name: SOCIAL_PROVIDERS
+  #   value: "allauth.socialaccount.providers.openid_connect"
+  # - name: SOCIALACCOUNT_PROVIDERS
+  #   value: '{"openid_connect":{"APPS":[{"provider_id":"authentik","name":"Authentik","client_id":"your-client-id","secret":"your-client-secret","settings":{"server_url":"https://authentik.company/application/o/tandoor/.well-known/openid-configuration"}}]}}'
+
+# Extra environment variables from secrets (recommended for sensitive data)
+extraEnvFrom: []
+  # - secretRef:
+  #     name: tandoor-extra-secrets