Discount Bandit Helm Chart
Deploy Discount Bandit on Kubernetes using the cybrarist/discount-bandit container image.
Discount Bandit is a self-hosted price tracker for products across multiple stores. It provides a web UI, scheduled crawling, price history, currency conversion, multi-user management, and notifications through services such as Ntfy, Telegram, and Gotify.
Features
- MySQL primary deployment path through the
helmforge/mysqlsubchart - SQLite development mode for small single-replica installs
- External MySQL/MariaDB support
- Gateway API
HTTPRouteand classic Kubernetes Ingress - Service dual-stack fields (
ipFamilyPolicy,ipFamilies) - External Secrets Operator v1 integration for
APP_KEY, exchange-rate key, and external database password - Optional NetworkPolicy for HTTP ingress, crawler egress, notification egress, DNS, and database egress
- Optional persistent logs volume mounted at
/logs - Optional PodDisruptionBudget
- Kubernetes-safe Supervisor base config that removes the upstream unauthenticated Supervisor HTTP endpoint
- Conservative runtime defaults with service account token automount disabled, RuntimeDefault seccomp, privilege escalation disabled, and explicit resources
- Production example with MySQL, Gateway API, NetworkPolicy, and resources
Installation
helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install discount-bandit helmforge/discount-bandit -n discount-bandit --create-namespace
OCI registry:
helm install discount-bandit oci://ghcr.io/helmforgedev/helm/discount-bandit -n discount-bandit --create-namespace
Default values deploy Discount Bandit with the HelmForge MySQL subchart.
Ready-to-use examples are available in examples/production.yaml, examples/sqlite.yaml,
examples/external-mysql.yaml, examples/external-secrets.yaml, and examples/gateway-api.yaml.
Access
kubectl port-forward -n discount-bandit svc/discount-bandit 8080:80
Open http://localhost:8080 and create the first admin account.
Application Listener
The FrankenPHP listener and Kubernetes Service port are independent:
| Purpose | Process listener | Service port |
|---|---|---|
| Discount Bandit HTTP | containerPorts.http (default 80) |
service.port (default 80) |
Changing containerPorts.http sets Laravel Octane's FrankenPHP --port
option in the Supervisor configuration, updates the container port and
NetworkPolicy, and keeps probes on the named http port. The Service targets
that named port, so its public port can be changed separately. Custom listener
ports require supervisor.configMap.enabled=true.
containerPorts:
http: 18080
service:
port: 18081
Production Example
discountBandit:
appUrl: https://deals.example.com
assetUrl: https://deals.example.com
timezone: UTC
themeColor: Stone
mysql:
enabled: true
standalone:
persistence:
enabled: true
size: 20Gi
gatewayAPI:
enabled: true
parentRefs:
- name: public-gateway
namespace: gateway-system
hostnames:
- deals.example.com
networkPolicy:
enabled: true
egress:
enabled: true
allowDNS: true
allowHTTPS: true
allowSameNamespaceDatabase: true
serviceAccount:
automountServiceAccountToken: false
resources:
requests:
cpu: 250m
memory: 512Mi
limits:
cpu: 1000m
memory: 1Gi
Database Modes
MySQL Subchart
MySQL is the primary default:
mysql:
enabled: true
auth:
database: discount_bandit
username: discount_bandit
The application reads the generated MySQL user password from the subchart Secret.
External MySQL
mysql:
enabled: false
database:
mode: external
external:
type: mysql
host: mysql.example.com
port: 3306
name: discount_bandit
username: discount_bandit
existingSecret: discount-bandit-db
existingSecretPasswordKey: database-password
SQLite Development Mode
mysql:
enabled: false
database:
mode: sqlite
sqlite:
enabled: true
persistence:
database:
enabled: true
size: 5Gi
Keep replicaCount=1 with SQLite.
External Secrets
mysql:
enabled: false
database:
mode: external
external:
host: mysql.example.com
name: discount_bandit
username: discount_bandit
externalSecrets:
enabled: true
secretStoreRef:
name: cluster-secrets
kind: ClusterSecretStore
app:
enabled: true
appKeyRemoteRef:
key: discount-bandit/app
property: app-key
exchangeRateApiKeyRemoteRef:
key: discount-bandit/app
property: exchange-rate-api-key
database:
enabled: true
passwordRemoteRef:
key: discount-bandit/mysql
property: password
The chart renders external-secrets.io/v1 resources.
Gateway API
gatewayAPI:
enabled: true
parentRefs:
- name: public-gateway
namespace: gateway-system
hostnames:
- deals.example.com
Use Gateway API when the cluster has a Gateway controller. Use ingress.enabled=true for classic Ingress controllers.
NetworkPolicy
Discount Bandit needs outbound network access for product crawling, exchange-rate API calls, and user-configured notification
services. Start with networkPolicy.enabled=false, then enable egress rules once you understand the required destinations.
networkPolicy:
enabled: true
egress:
enabled: true
allowDNS: true
allowHTTPS: true
allowSameNamespaceDatabase: true
Values & Configuration Reference
All schema parameters, types, defaults, and allowed values are extracted directly from the chart repository. Filter and search them in the interactive reference below or customize in Values Studio.
|-----|---------|-------------|
| mysql.enabled | true | Deploy HelmForge MySQL as the primary database. |
| mysql.standalone.resources.requests.cpu | 250m | Default CPU request for the bundled MySQL pod. |
| mysql.standalone.resources.requests.memory | 512Mi | Default memory request for the bundled MySQL pod. |
| mysql.standalone.resources.limits.cpu | 1000m | Default CPU limit for the bundled MySQL pod. |
| mysql.standalone.resources.limits.memory | 1Gi | Default memory limit for the bundled MySQL pod. |
| database.mode | auto | Database mode: auto, mysql, external, or sqlite. |
| database.sqlite.enabled | false | Enables explicit SQLite development mode. |
| discountBandit.appUrl | "" | Public application URL (APP_URL). |
| discountBandit.assetUrl | "" | Public asset URL (ASSET_URL). |
| discountBandit.cron | */5 * * * * | Product crawl schedule. |
| discountBandit.themeColor | Stone | UI theme color. |
| discountBandit.exchangeRateApiKey | "" | ExchangeRate API key; prefer Secret/ExternalSecret. |
| containerPorts.http | 80 | FrankenPHP HTTP application listener. |
| service.port | 80 | Kubernetes Service port targeting the named HTTP listener. |
| service.ipFamilyPolicy | "" | Optional dual-stack Service policy. |
| service.ipFamilies | [] | Optional Service IP families. |
| gatewayAPI.enabled | false | Render Gateway API HTTPRoute. |
| externalSecrets.enabled | false | Enable External Secrets Operator resources. |
| networkPolicy.enabled | false | Render NetworkPolicy. |
| serviceAccount.automountServiceAccountToken | false | Disable Kubernetes API token mount by default. |
| resources.requests.cpu | 250m | Default CPU request for the Discount Bandit container. |
| resources.requests.memory | 512Mi | Default memory request for the Discount Bandit container. |
| resources.limits.cpu | 1000m | Default CPU limit for the Discount Bandit container. |
| resources.limits.memory | 1Gi | Default memory limit for the Discount Bandit container. |
| podSecurityContext.seccompProfile.type | RuntimeDefault | Use the Kubernetes RuntimeDefault seccomp profile. |
| securityContext.allowPrivilegeEscalation | false | Disable privilege escalation for the application container. |
| persistence.logs.enabled | false | Persist /logs instead of using emptyDir. |
| supervisor.configMap.enabled | true | Replace the upstream Supervisor base config with a Kubernetes-safe config. |
| pdb.enabled | false | Render PodDisruptionBudget. |
Security Scan
Security Scan: discount-bandit
| Framework | Score |
|---|---|
| MITRE + NSA + SOC2 | 91.21% |
| MITRE | 100.00% |
| NSA | 87.50% |
| SOC2 | 92.00% |
The remaining expected findings are tied to the upstream root runtime, writable application filesystem needs, and NetworkPolicy/firewall decisions that depend on crawler and notification destinations.
Operational Notes
- The upstream container runs FrankenPHP, Laravel scheduler, queue worker, and Chromium-based crawlers under Supervisor.
- Some stores require Chromium headless; review pod logs when validating product crawling.
- The chart waits for MySQL before starting the application container in MySQL and external database modes.
- By default the chart mounts a sanitized Supervisor base config without the upstream unauthenticated
inet_http_server. - SQLite is suitable for development and small personal installs only.
- Production deployments should use the MySQL subchart or external MySQL/MariaDB.
- Enable NetworkPolicy carefully because product crawling and notifications need outbound internet access.
- See the operations guide for runtime, database, crawler egress, routing, and validation guidance.
More Information
System Architecture
DESIGN.md SyncedVerified architecture contract rendered dynamically from GitHub DESIGN.md
This is the default topology. The MySQL subchart owns database credentials, persistence, and lifecycle controls.
flowchart TB users[Users] --> edge[Gateway API or Ingress] edge --> service[Discount Bandit Service] service --> app[Discount Bandit Deployment] app --> web[FrankenPHP web UI] app --> scheduler[Laravel scheduler] app --> worker[Laravel queue worker] app --> crawler[Chromium crawler runtime] app --> mysqlService[MySQL Service] mysqlService --> mysql[MySQL StatefulSet] mysql --> mysqlPvc[(MySQL data PVC)]
Discount Bandit Values Schema Reference
Official schema parameters, default values, and types extracted directly from the chart repository.
Global(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| global | object | - | Chart configuration parameter |
Name Override(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| nameOverride | string | - | Chart configuration parameter |
Fullname Override(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| fullnameOverride | string | - | Chart configuration parameter |
Common Labels(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| commonLabels | any | - | Chart configuration parameter |
Replica Count(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| replicaCount | integer | - | Chart configuration parameter |
Image(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| image.repository | string | - | Chart configuration parameter |
| image.tag | string | - | Chart configuration parameter |
| image.pullPolicy | string | - | Chart configuration parameter Allowed: AlwaysIfNotPresentNever |
Image Pull Secrets(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| imagePullSecrets | array | - | Chart configuration parameter |
Container Ports(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| containerPorts.http | integer | - | Chart configuration parameter |
Discount Bandit(10)
| Parameter | Type | Default | Description |
|---|---|---|---|
| discountBandit.appUrl | string | - | Chart configuration parameter |
| discountBandit.assetUrl | string | - | Chart configuration parameter |
| discountBandit.timezone | string | - | Chart configuration parameter |
| discountBandit.themeColor | string | - | Chart configuration parameter Allowed: SlateGrayZincNeutralStoneRedOrangeAmberYellowLimeGreenEmeraldTealCyanSkyBlueIndigoVioletPurpleFuchsiaPinkRose |
| discountBandit.cron | string | - | Chart configuration parameter |
| discountBandit.exchangeRateApiKey | string | - | Chart configuration parameter |
| discountBandit.existingSecret | string | - | Chart configuration parameter |
| discountBandit.existingSecretAppKeyKey | string | - | Chart configuration parameter |
| discountBandit.existingSecretExchangeRateApiKeyKey | string | - | Chart configuration parameter |
| discountBandit.extraEnv | array | - | Chart configuration parameter |
Database(10)
| Parameter | Type | Default | Description |
|---|---|---|---|
| database.mode | string | - | Chart configuration parameter Allowed: automysqlexternalsqlite |
| database.sqlite.enabled | boolean | - | Chart configuration parameter |
| database.external.type | string | - | Chart configuration parameter Allowed: mysqlmariadb |
| database.external.host | string | - | Chart configuration parameter |
| database.external.port | integer | - | Chart configuration parameter |
| database.external.name | string | - | Chart configuration parameter |
| database.external.username | string | - | Chart configuration parameter |
| database.external.password | string | - | Chart configuration parameter |
| database.external.existingSecret | string | - | Chart configuration parameter |
| database.external.existingSecretPasswordKey | string | - | Chart configuration parameter |
Mysql(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| mysql | object | - | Chart configuration parameter |
Persistence(12)
| Parameter | Type | Default | Description |
|---|---|---|---|
| persistence.database.enabled | boolean | - | Chart configuration parameter |
| persistence.database.size | string | - | Chart configuration parameter |
| persistence.database.storageClass | string | - | Chart configuration parameter |
| persistence.database.accessModes | array | - | Chart configuration parameter |
| persistence.database.existingClaim | string | - | Chart configuration parameter |
| persistence.database.annotations | any | - | Chart configuration parameter |
| persistence.logs.enabled | boolean | - | Chart configuration parameter |
| persistence.logs.size | string | - | Chart configuration parameter |
| persistence.logs.storageClass | string | - | Chart configuration parameter |
| persistence.logs.accessModes | array | - | Chart configuration parameter |
| persistence.logs.existingClaim | string | - | Chart configuration parameter |
| persistence.logs.annotations | any | - | Chart configuration parameter |
Service Account(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| serviceAccount.create | boolean | - | Chart configuration parameter |
| serviceAccount.name | string | - | Chart configuration parameter |
| serviceAccount.annotations | any | - | Chart configuration parameter |
| serviceAccount.automountServiceAccountToken | boolean | - | Chart configuration parameter |
Service & Networking(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| service.type | string | - | Chart configuration parameter Allowed: ClusterIPNodePortLoadBalancer |
| service.port | integer | - | Chart configuration parameter |
| service.annotations | any | - | Chart configuration parameter |
| service.ipFamilyPolicy | string | - | Chart configuration parameter Allowed: SingleStackPreferDualStackRequireDualStack |
| service.ipFamilies | array | - | Chart configuration parameter |
Ingress(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| ingress.enabled | boolean | - | Chart configuration parameter |
| ingress.ingressClassName | string | - | Chart configuration parameter |
| ingress.annotations | any | - | Chart configuration parameter |
| ingress.hosts | array | - | Chart configuration parameter |
| ingress.tls | array | - | Chart configuration parameter |
Gateway API(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| gatewayAPI.enabled | boolean | - | Chart configuration parameter |
| gatewayAPI.parentRefs | array | - | Chart configuration parameter |
| gatewayAPI.hostnames | array | - | Chart configuration parameter |
| gatewayAPI.annotations | any | - | Chart configuration parameter |
| gatewayAPI.matches | array | - | Chart configuration parameter |
| gatewayAPI.filters | array | - | Chart configuration parameter |
External Secrets(16)
| Parameter | Type | Default | Description |
|---|---|---|---|
| externalSecrets.enabled | boolean | - | Chart configuration parameter |
| externalSecrets.apiVersion | string | - | Chart configuration parameter Allowed: external-secrets.io/v1 |
| externalSecrets.refreshInterval | string | - | Chart configuration parameter |
| externalSecrets.secretStoreRef.name | string | - | Chart configuration parameter |
| externalSecrets.secretStoreRef.kind | string | - | Chart configuration parameter Allowed: SecretStoreClusterSecretStore |
| externalSecrets.target.creationPolicy | string | - | Chart configuration parameter Allowed: OwnerOrphanMergeNone |
| externalSecrets.app.enabled | boolean | - | Chart configuration parameter |
| externalSecrets.app.targetName | string | - | Chart configuration parameter |
| externalSecrets.app.appKeyRemoteRef.key | string | - | Chart configuration parameter |
| externalSecrets.app.appKeyRemoteRef.property | string | - | Chart configuration parameter |
| externalSecrets.app.exchangeRateApiKeyRemoteRef.key | string | - | Chart configuration parameter |
| externalSecrets.app.exchangeRateApiKeyRemoteRef.property | string | - | Chart configuration parameter |
| externalSecrets.database.enabled | boolean | - | Chart configuration parameter |
| externalSecrets.database.targetName | string | - | Chart configuration parameter |
| externalSecrets.database.passwordRemoteRef.key | string | - | Chart configuration parameter |
| externalSecrets.database.passwordRemoteRef.property | string | - | Chart configuration parameter |
Health Probes(15)
| Parameter | Type | Default | Description |
|---|---|---|---|
| probes.startup.enabled | boolean | - | Chart configuration parameter |
| probes.startup.initialDelaySeconds | integer | - | Chart configuration parameter |
| probes.startup.periodSeconds | integer | - | Chart configuration parameter |
| probes.startup.timeoutSeconds | integer | - | Chart configuration parameter |
| probes.startup.failureThreshold | integer | - | Chart configuration parameter |
| probes.liveness.enabled | boolean | - | Chart configuration parameter |
| probes.liveness.initialDelaySeconds | integer | - | Chart configuration parameter |
| probes.liveness.periodSeconds | integer | - | Chart configuration parameter |
| probes.liveness.timeoutSeconds | integer | - | Chart configuration parameter |
| probes.liveness.failureThreshold | integer | - | Chart configuration parameter |
| probes.readiness.enabled | boolean | - | Chart configuration parameter |
| probes.readiness.initialDelaySeconds | integer | - | Chart configuration parameter |
| probes.readiness.periodSeconds | integer | - | Chart configuration parameter |
| probes.readiness.timeoutSeconds | integer | - | Chart configuration parameter |
| probes.readiness.failureThreshold | integer | - | Chart configuration parameter |
Supervisor(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| supervisor.configMap.enabled | boolean | - | Chart configuration parameter |
Resources(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| resources | object | - | Chart configuration parameter |
Pod Security(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podSecurityContext | object | - | Chart configuration parameter |
Container Security(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| securityContext | object | - | Chart configuration parameter |
Network Policy(11)
| Parameter | Type | Default | Description |
|---|---|---|---|
| networkPolicy.enabled | boolean | - | Chart configuration parameter |
| networkPolicy.ingress.allowSameNamespace | boolean | - | Chart configuration parameter |
| networkPolicy.ingress.extraFrom | array | - | Chart configuration parameter |
| networkPolicy.egress.enabled | boolean | - | Chart configuration parameter |
| networkPolicy.egress.allowDNS | boolean | - | Chart configuration parameter |
| networkPolicy.egress.allowHTTPS | boolean | - | Chart configuration parameter |
| networkPolicy.egress.allowHTTP | boolean | - | Chart configuration parameter |
| networkPolicy.egress.allowSameNamespaceDatabase | boolean | - | Chart configuration parameter |
| networkPolicy.egress.databasePort | integer | - | Chart configuration parameter |
| networkPolicy.egress.extraTo | array | - | Chart configuration parameter |
| networkPolicy.egress.extraEgress | array | - | Chart configuration parameter |
Pdb(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| pdb.enabled | boolean | - | Chart configuration parameter |
| pdb.minAvailable | any | - | Chart configuration parameter |
| pdb.maxUnavailable | any | - | Chart configuration parameter |
Node Selector(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| nodeSelector | object | - | Chart configuration parameter |
Tolerations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| tolerations | array | - | Chart configuration parameter |
Affinity(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| affinity | object | - | Chart configuration parameter |
Topology Spread Constraints(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| topologySpreadConstraints | array | - | Chart configuration parameter |
Priority Class Name(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| priorityClassName | string | - | Chart configuration parameter |
Termination Grace Period Seconds(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| terminationGracePeriodSeconds | integer | - | Chart configuration parameter |
Pod Labels(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podLabels | any | - | Chart configuration parameter |
Pod Annotations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podAnnotations | any | - | Chart configuration parameter |
Extra Volumes(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumes | array | - | Chart configuration parameter |
Extra Volume Mounts(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumeMounts | array | - | Chart configuration parameter |
Extra Init Containers(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraInitContainers | array | - | Chart configuration parameter |
Extra Containers(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraContainers | array | - | Chart configuration parameter |
Extra Manifests(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraManifests | array | - | Chart configuration parameter |
No schema parameters match your search
Try searching for a different keyword or reset the filter.