Skip to content
Discount Bandit icon
v2.1.2App: v4.0.5Pinned DigestS3 Backup Ready

Production Helm chart • Apache-2.0 • Zero-Root • Verified on Kubernetes v1.33-v1.36+

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/mysql subchart
  • SQLite development mode for small single-replica installs
  • External MySQL/MariaDB support
  • Gateway API HTTPRoute and 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
Official Schema

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.

View Values Schema

|-----|---------|-------------| | 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 Synced

Verified 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)]
Official Contractvalues.schema.json

Discount Bandit Values Schema Reference

Official schema parameters, default values, and types extracted directly from the chart repository.

125 parametersValues Studio

Global(1)

ParameterTypeDefaultDescription
globalobject-Chart configuration parameter

Name Override(1)

ParameterTypeDefaultDescription
nameOverridestring-Chart configuration parameter

Fullname Override(1)

ParameterTypeDefaultDescription
fullnameOverridestring-Chart configuration parameter

Common Labels(1)

ParameterTypeDefaultDescription
commonLabelsany-Chart configuration parameter

Replica Count(1)

ParameterTypeDefaultDescription
replicaCountinteger-Chart configuration parameter

Image(3)

ParameterTypeDefaultDescription
image.repositorystring-Chart configuration parameter
image.tagstring-Chart configuration parameter
image.pullPolicystring-Chart configuration parameter
Allowed:AlwaysIfNotPresentNever

Image Pull Secrets(1)

ParameterTypeDefaultDescription
imagePullSecretsarray-Chart configuration parameter

Container Ports(1)

ParameterTypeDefaultDescription
containerPorts.httpinteger-Chart configuration parameter

Discount Bandit(10)

ParameterTypeDefaultDescription
discountBandit.appUrlstring-Chart configuration parameter
discountBandit.assetUrlstring-Chart configuration parameter
discountBandit.timezonestring-Chart configuration parameter
discountBandit.themeColorstring-Chart configuration parameter
Allowed:SlateGrayZincNeutralStoneRedOrangeAmberYellowLimeGreenEmeraldTealCyanSkyBlueIndigoVioletPurpleFuchsiaPinkRose
discountBandit.cronstring-Chart configuration parameter
discountBandit.exchangeRateApiKeystring-Chart configuration parameter
discountBandit.existingSecretstring-Chart configuration parameter
discountBandit.existingSecretAppKeyKeystring-Chart configuration parameter
discountBandit.existingSecretExchangeRateApiKeyKeystring-Chart configuration parameter
discountBandit.extraEnvarray-Chart configuration parameter

Database(10)

ParameterTypeDefaultDescription
database.modestring-Chart configuration parameter
Allowed:automysqlexternalsqlite
database.sqlite.enabledboolean-Chart configuration parameter
database.external.typestring-Chart configuration parameter
Allowed:mysqlmariadb
database.external.hoststring-Chart configuration parameter
database.external.portinteger-Chart configuration parameter
database.external.namestring-Chart configuration parameter
database.external.usernamestring-Chart configuration parameter
database.external.passwordstring-Chart configuration parameter
database.external.existingSecretstring-Chart configuration parameter
database.external.existingSecretPasswordKeystring-Chart configuration parameter

Mysql(1)

ParameterTypeDefaultDescription
mysqlobject-Chart configuration parameter

Persistence(12)

ParameterTypeDefaultDescription
persistence.database.enabledboolean-Chart configuration parameter
persistence.database.sizestring-Chart configuration parameter
persistence.database.storageClassstring-Chart configuration parameter
persistence.database.accessModesarray-Chart configuration parameter
persistence.database.existingClaimstring-Chart configuration parameter
persistence.database.annotationsany-Chart configuration parameter
persistence.logs.enabledboolean-Chart configuration parameter
persistence.logs.sizestring-Chart configuration parameter
persistence.logs.storageClassstring-Chart configuration parameter
persistence.logs.accessModesarray-Chart configuration parameter
persistence.logs.existingClaimstring-Chart configuration parameter
persistence.logs.annotationsany-Chart configuration parameter

Service Account(4)

ParameterTypeDefaultDescription
serviceAccount.createboolean-Chart configuration parameter
serviceAccount.namestring-Chart configuration parameter
serviceAccount.annotationsany-Chart configuration parameter
serviceAccount.automountServiceAccountTokenboolean-Chart configuration parameter

Service & Networking(5)

ParameterTypeDefaultDescription
service.typestring-Chart configuration parameter
Allowed:ClusterIPNodePortLoadBalancer
service.portinteger-Chart configuration parameter
service.annotationsany-Chart configuration parameter
service.ipFamilyPolicystring-Chart configuration parameter
Allowed:SingleStackPreferDualStackRequireDualStack
service.ipFamiliesarray-Chart configuration parameter

Ingress(5)

ParameterTypeDefaultDescription
ingress.enabledboolean-Chart configuration parameter
ingress.ingressClassNamestring-Chart configuration parameter
ingress.annotationsany-Chart configuration parameter
ingress.hostsarray-Chart configuration parameter
ingress.tlsarray-Chart configuration parameter

Gateway API(6)

ParameterTypeDefaultDescription
gatewayAPI.enabledboolean-Chart configuration parameter
gatewayAPI.parentRefsarray-Chart configuration parameter
gatewayAPI.hostnamesarray-Chart configuration parameter
gatewayAPI.annotationsany-Chart configuration parameter
gatewayAPI.matchesarray-Chart configuration parameter
gatewayAPI.filtersarray-Chart configuration parameter

External Secrets(16)

ParameterTypeDefaultDescription
externalSecrets.enabledboolean-Chart configuration parameter
externalSecrets.apiVersionstring-Chart configuration parameter
Allowed:external-secrets.io/v1
externalSecrets.refreshIntervalstring-Chart configuration parameter
externalSecrets.secretStoreRef.namestring-Chart configuration parameter
externalSecrets.secretStoreRef.kindstring-Chart configuration parameter
Allowed:SecretStoreClusterSecretStore
externalSecrets.target.creationPolicystring-Chart configuration parameter
Allowed:OwnerOrphanMergeNone
externalSecrets.app.enabledboolean-Chart configuration parameter
externalSecrets.app.targetNamestring-Chart configuration parameter
externalSecrets.app.appKeyRemoteRef.keystring-Chart configuration parameter
externalSecrets.app.appKeyRemoteRef.propertystring-Chart configuration parameter
externalSecrets.app.exchangeRateApiKeyRemoteRef.keystring-Chart configuration parameter
externalSecrets.app.exchangeRateApiKeyRemoteRef.propertystring-Chart configuration parameter
externalSecrets.database.enabledboolean-Chart configuration parameter
externalSecrets.database.targetNamestring-Chart configuration parameter
externalSecrets.database.passwordRemoteRef.keystring-Chart configuration parameter
externalSecrets.database.passwordRemoteRef.propertystring-Chart configuration parameter

Health Probes(15)

ParameterTypeDefaultDescription
probes.startup.enabledboolean-Chart configuration parameter
probes.startup.initialDelaySecondsinteger-Chart configuration parameter
probes.startup.periodSecondsinteger-Chart configuration parameter
probes.startup.timeoutSecondsinteger-Chart configuration parameter
probes.startup.failureThresholdinteger-Chart configuration parameter
probes.liveness.enabledboolean-Chart configuration parameter
probes.liveness.initialDelaySecondsinteger-Chart configuration parameter
probes.liveness.periodSecondsinteger-Chart configuration parameter
probes.liveness.timeoutSecondsinteger-Chart configuration parameter
probes.liveness.failureThresholdinteger-Chart configuration parameter
probes.readiness.enabledboolean-Chart configuration parameter
probes.readiness.initialDelaySecondsinteger-Chart configuration parameter
probes.readiness.periodSecondsinteger-Chart configuration parameter
probes.readiness.timeoutSecondsinteger-Chart configuration parameter
probes.readiness.failureThresholdinteger-Chart configuration parameter

Supervisor(1)

ParameterTypeDefaultDescription
supervisor.configMap.enabledboolean-Chart configuration parameter

Resources(1)

ParameterTypeDefaultDescription
resourcesobject-Chart configuration parameter

Pod Security(1)

ParameterTypeDefaultDescription
podSecurityContextobject-Chart configuration parameter

Container Security(1)

ParameterTypeDefaultDescription
securityContextobject-Chart configuration parameter

Network Policy(11)

ParameterTypeDefaultDescription
networkPolicy.enabledboolean-Chart configuration parameter
networkPolicy.ingress.allowSameNamespaceboolean-Chart configuration parameter
networkPolicy.ingress.extraFromarray-Chart configuration parameter
networkPolicy.egress.enabledboolean-Chart configuration parameter
networkPolicy.egress.allowDNSboolean-Chart configuration parameter
networkPolicy.egress.allowHTTPSboolean-Chart configuration parameter
networkPolicy.egress.allowHTTPboolean-Chart configuration parameter
networkPolicy.egress.allowSameNamespaceDatabaseboolean-Chart configuration parameter
networkPolicy.egress.databasePortinteger-Chart configuration parameter
networkPolicy.egress.extraToarray-Chart configuration parameter
networkPolicy.egress.extraEgressarray-Chart configuration parameter

Pdb(3)

ParameterTypeDefaultDescription
pdb.enabledboolean-Chart configuration parameter
pdb.minAvailableany-Chart configuration parameter
pdb.maxUnavailableany-Chart configuration parameter

Node Selector(1)

ParameterTypeDefaultDescription
nodeSelectorobject-Chart configuration parameter

Tolerations(1)

ParameterTypeDefaultDescription
tolerationsarray-Chart configuration parameter

Affinity(1)

ParameterTypeDefaultDescription
affinityobject-Chart configuration parameter

Topology Spread Constraints(1)

ParameterTypeDefaultDescription
topologySpreadConstraintsarray-Chart configuration parameter

Priority Class Name(1)

ParameterTypeDefaultDescription
priorityClassNamestring-Chart configuration parameter

Termination Grace Period Seconds(1)

ParameterTypeDefaultDescription
terminationGracePeriodSecondsinteger-Chart configuration parameter

Pod Labels(1)

ParameterTypeDefaultDescription
podLabelsany-Chart configuration parameter

Pod Annotations(1)

ParameterTypeDefaultDescription
podAnnotationsany-Chart configuration parameter

Extra Volumes(1)

ParameterTypeDefaultDescription
extraVolumesarray-Chart configuration parameter

Extra Volume Mounts(1)

ParameterTypeDefaultDescription
extraVolumeMountsarray-Chart configuration parameter

Extra Init Containers(1)

ParameterTypeDefaultDescription
extraInitContainersarray-Chart configuration parameter

Extra Containers(1)

ParameterTypeDefaultDescription
extraContainersarray-Chart configuration parameter

Extra Manifests(1)

ParameterTypeDefaultDescription
extraManifestsarray-Chart configuration parameter