Skip to content
Answer icon
v1.5.9App: v2.0.3Pinned DigestS3 Backup Ready

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

Apache Answer Helm Chart

Deploy Apache Answer on Kubernetes with an official, pinned image, persistent storage, explicit listener configuration, optional SQL databases, secure defaults, and database-aware backups.

Features

  • SQLite by default for a small, zero-dependency installation.
  • Optional HelmForge PostgreSQL and MySQL 2.1.1 subcharts.
  • External PostgreSQL or MySQL with passwords sourced from an existing Secret.
  • Unattended initial setup using the environment variables supported upstream.
  • A configurable application listener independent from the Kubernetes Service port.
  • Startup, liveness, and readiness probes against the named HTTP port.
  • A default ingress NetworkPolicy that exposes only the Answer HTTP listener.
  • RuntimeDefault seccomp, non-root execution, a read-only root filesystem, dropped capabilities, and disabled service-account-token mounting.
  • Ingress and Gateway API routing, dual-stack Services, External Secrets, and database-aware S3-compatible backups.
  • Scheduling controls, extra volumes, pod metadata, and extra manifests.

Architecture

The chart always deploys one Answer server and one Service. The Service forwards its client-facing service.port to the named http container port. Answer receives INSTALL_PORT, SITE_ADDR, and SWAGGER_ADDRESS_PORT from containerPorts.http, so changing the value changes the process listener instead of only changing Kubernetes metadata.

SQLite stores the database, uploads, generated configuration, and plugins under /data. PostgreSQL and MySQL modes retain the Answer data volume for uploads and application state while placing relational data in the selected database. See DESIGN.md for trust boundaries and lifecycle decisions.

Installation

Install from the HTTPS repository:

helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install answer helmforge/answer

Or install from OCI:

helm install answer oci://ghcr.io/helmforgedev/helm/answer

Inspect every supported value before production use:

helm show values helmforge/answer

Usage Examples

SQLite

SQLite is suitable for evaluation and small installations with a single Answer pod. Keep persistence enabled because /data contains both the database and uploaded content.

answer:
  siteName: My Q&A
  siteUrl: https://qa.example.com

admin:
  existingSecret: answer-admin
  existingSecretPasswordKey: admin-password

persistence:
  enabled: true
  size: 10Gi

Bundled PostgreSQL

database:
  mode: postgresql

postgresql:
  enabled: true
  auth:
    database: answer
    username: answer
    password: replace-me
  standalone:
    persistence:
      enabled: true
      size: 20Gi

For GitOps with an external database, provide credentials through database.external.existingSecret and externalSecrets.database. Bundled PostgreSQL mode rejects database.external.existingSecret, so this flow does not apply to the bundled database.

External database

database:
  mode: external
  external:
    vendor: postgres
    host: postgres.database.svc.cluster.local
    port: "5432"
    name: answer
    username: answer
    existingSecret: answer-database
    existingSecretPasswordKey: database-password

The chart rejects ambiguous combinations, such as enabling a bundled database while also configuring an external host.

Independent listener and Service ports

containerPorts:
  http: 8080

service:
  port: 9080

This makes Answer listen on 8080 inside the pod while clients use port 9080 on the Service. Probes and the named Service target continue to follow the real listener. Do not add INSTALL_PORT, SITE_ADDR, or SWAGGER_ADDRESS_PORT to answer.extraEnv; the chart rejects those overrides to prevent split-brain port configuration.

Configuration

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

The JSON schema validates the full values contract. Database, backup, routing, and External Secrets examples are also available under examples/ and docs/.

Security

The default pod runs as UID/GID 1000, uses RuntimeDefault seccomp, prevents privilege escalation, drops all Linux capabilities, and adds only NET_BIND_SERVICE because the official default listener is port 80. The root filesystem is read-only; writable state is limited to /data and an ephemeral /tmp. The application does not need Kubernetes API access, so token automounting is disabled.

The default NetworkPolicy selects only the Answer server component. It accepts traffic solely on the named HTTP port and does not impose egress restrictions, because Answer may need SMTP, identity-provider, plugin, and embedded-content connections. With an empty networkPolicy.extraIngress, any source can reach the HTTP listener. Populate the list with namespace or pod selectors to restrict the allowed sources to your ingress controller or gateway.

Secrets generated by the chart are intended for initial setup. For production, use admin.existingSecret, database existing-Secret settings, or the optional External Secrets integration. Never store real credentials in a committed values file.

Operations and Troubleshooting

Check rollout and application health:

kubectl rollout status deployment/RELEASE-answer -n NAMESPACE
kubectl get pods,svc,pvc -n NAMESPACE -l app.kubernetes.io/instance=RELEASE
kubectl logs deployment/RELEASE-answer -n NAMESPACE -c answer --tail=200

If probes fail after changing ports, compare containerPorts.http with the rendered SITE_ADDR; service.port may differ, but targetPort must remain the named http port. Confirm the process endpoint through the Service:

kubectl run answer-health -n NAMESPACE --rm -i --restart=Never \
  --image=docker.io/library/busybox:1.37 -- \
  wget -qO- http://RELEASE-answer:SERVICE_PORT/healthz

For database startup failures, inspect the wait-for-db init container and verify DNS, port, credentials, and the selected database.mode:

kubectl logs deployment/RELEASE-answer -n NAMESPACE -c wait-for-db

Back up /data and the selected database before changing database mode, storage classes, or major application versions. The chart does not migrate data between SQLite, PostgreSQL, and MySQL. See database operations, backup and restore, routing, and External Secrets. The security guide explains hardening overrides and policy behavior.

Resources Generated

Resource Condition
Deployment, Service, NetworkPolicy Always, except NetworkPolicy when disabled
ServiceAccount serviceAccount.create
Admin or database Secret No corresponding existing Secret is configured
PVC Persistence enabled without an existing claim
Ingress or HTTPRoute Corresponding routing option enabled
ExternalSecret External Secrets and the specific secret type enabled
Backup ConfigMap, Secret, and CronJob Backup enabled

More Information

Security Scan: answer

Framework Score
MITRE + NSA + SOC2 86.580086%

Security posture: acceptable.

System Architecture

DESIGN.md Synced

Verified architecture contract rendered dynamically from GitHub DESIGN.md

flowchart TB
  client[HTTP client] --> route[Ingress or HTTPRoute]
  route --> service[Answer Service]
  service --> server[Answer server pod]
  server --> data[(Answer data PVC)]
  server --> database[(SQLite, PostgreSQL, MySQL, or external DB)]
  adminSecret[Admin Secret] --> server
  databaseSecret[Database Secret] --> server
  eso[External Secrets Operator] -. optional reconciliation .-> adminSecret
  eso -. optional reconciliation .-> databaseSecret
  backup[Backup CronJob] -->|SQLite mode only| data
  backup -->|SQL dump in PostgreSQL or MySQL mode| database
  backup --> objectStorage[S3-compatible object storage]
Official Contractvalues.schema.json

Answer Values Schema Reference

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

163 parametersValues Studio

Global(1)

ParameterTypeDefaultDescription
globalobject-Global settings shared by the chart.

Name Override(1)

ParameterTypeDefaultDescription
nameOverridestring-Override the chart name used in resource names.

Fullname Override(1)

ParameterTypeDefaultDescription
fullnameOverridestring-Override the full release name used in resource names.

Common Labels(1)

ParameterTypeDefaultDescription
commonLabelsobject-Labels added to every resource created by this chart.

Image(3)

ParameterTypeDefaultDescription
image.repositorystring-Container image repository.
image.tagstring-Container image tag (defaults to appVersion).
image.pullPolicystring-Image pull policy.
Allowed:AlwaysIfNotPresentNever

Image Pull Secrets(1)

ParameterTypeDefaultDescription
imagePullSecretsarray-Image pull secrets for private registries.

Answer(10)

ParameterTypeDefaultDescription
answer.siteUrlstring-Full external URL of the site (auto-detected from Ingress or Gateway hostname if empty).
answer.siteNamestring-Site name displayed in the browser tab and header.
answer.languagestring-Default language for the UI.
answer.contactEmailstring-Contact email shown in the site footer and admin.
answer.externalContentDisplaystring-External content display policy used by Answer auto-install.
Allowed:always_displayask_before_display
answer.autoInstallboolean-Enable automatic installation via environment variables.
answer.logLevelstring-Log level: DEBUG, INFO, WARN, ERROR.
Allowed:DEBUGINFOWARNERROR
answer.notifications.newQuestionEmail.queueSizeinteger-Maximum number of new-question email tasks buffered by the Answer worker.
answer.notifications.newQuestionEmail.sendIntervalSecondsinteger-Delay in seconds between new-question email attempts; 0 disables throttling.
answer.extraEnvarray-Additional environment variables for the Answer container.

Admin(5)

ParameterTypeDefaultDescription
admin.namestring-Admin username for initial setup.
admin.passwordstring-Admin password (auto-generated if empty and no existingSecret).
admin.emailstring-Admin email address.
admin.existingSecretstring-Use an existing secret for admin credentials.
admin.existingSecretPasswordKeystring-Key in the existing secret for the admin password.

Database(10)

ParameterTypeDefaultDescription
database.modestring-Database mode: auto | sqlite | external | postgresql | mysql.
Allowed:autosqliteexternalpostgresqlmysql
database.sqlite.filestring-SQLite database file path inside the data volume.
database.external.vendorstring-Database vendor: postgres | mysql.
Allowed:postgresmysql
database.external.hoststring-External database hostname.
database.external.portstringinteger-External database port (auto-detected from vendor if empty).
database.external.namestring-Database name.
database.external.usernamestring-Database username.
database.external.passwordstring-Database password (ignored when existingSecret is set).
database.external.existingSecretstring-Existing secret for the database password.
database.external.existingSecretPasswordKeystring-Key in the existing secret for the database password.

Postgresql(7)

ParameterTypeDefaultDescription
postgresql.enabledboolean-Deploy PostgreSQL as a subchart.
postgresql.architecturestring-PostgreSQL architecture (standalone or replication).
postgresql.auth.databasestring-Database name created on first run.
postgresql.auth.usernamestring-Database username created on first run.
postgresql.auth.passwordstring-Database password (auto-generated if empty).
postgresql.standalone.persistence.enabledboolean-Enable persistence for PostgreSQL data.
postgresql.standalone.persistence.sizestring-PVC size for PostgreSQL.

Mysql(8)

ParameterTypeDefaultDescription
mysql.enabledboolean-Deploy MySQL as a subchart.
mysql.architecturestring-MySQL architecture (standalone or replication).
mysql.auth.databasestring-Database name created on first run.
mysql.auth.usernamestring-Database username created on first run.
mysql.auth.passwordstring-Database password (auto-generated if empty).
mysql.auth.rootPasswordstring-Root password (auto-generated if empty).
mysql.standalone.persistence.enabledboolean-Enable persistence for MySQL data.
mysql.standalone.persistence.sizestring-PVC size for MySQL.

Persistence(6)

ParameterTypeDefaultDescription
persistence.enabledboolean-Enable persistent storage for /data.
persistence.storageClassstring-Storage class (leave empty for cluster default).
persistence.accessModestring-Access mode for the PVC.
persistence.sizestring-Size of the persistent volume.
persistence.existingClaimstring-Use an existing PVC instead of creating one.
persistence.annotationsobject-Annotations for the PVC.

Resources(4)

ParameterTypeDefaultDescription
resources.requests.cpustringnumber-Chart configuration parameter
resources.requests.memorystring-Chart configuration parameter
resources.limits.cpustringnumber-Chart configuration parameter
resources.limits.memorystring-Chart configuration parameter

Pod Security(6)

ParameterTypeDefaultDescription
podSecurityContext.runAsNonRootboolean-Chart configuration parameter
podSecurityContext.runAsUserinteger-Chart configuration parameter
podSecurityContext.runAsGroupinteger-Chart configuration parameter
podSecurityContext.fsGroupinteger-Chart configuration parameter
podSecurityContext.fsGroupChangePolicystring-Chart configuration parameter
Allowed:AlwaysOnRootMismatch
podSecurityContext.seccompProfile.typestring-Chart configuration parameter

Container Security(4)

ParameterTypeDefaultDescription
securityContext.allowPrivilegeEscalationbooleanfalseChart configuration parameter
securityContext.readOnlyRootFilesystembooleantrueChart configuration parameter
securityContext.capabilities.droparray["ALL"]Chart configuration parameter
securityContext.capabilities.addarray["NET_BIND_SERVICE"]Chart configuration parameter

Container Ports(1)

ParameterTypeDefaultDescription
containerPorts.httpinteger-HTTP port opened by the Apache Answer process.

Startup Probe(6)

ParameterTypeDefaultDescription
startupProbe.enabledboolean-Enable startup probe.
startupProbe.pathstring-Path for HTTP GET probe.
startupProbe.initialDelaySecondsinteger-Chart configuration parameter
startupProbe.periodSecondsinteger-Chart configuration parameter
startupProbe.timeoutSecondsinteger-Chart configuration parameter
startupProbe.failureThresholdinteger-Chart configuration parameter

Liveness Probe(6)

ParameterTypeDefaultDescription
livenessProbe.enabledboolean-Enable liveness probe.
livenessProbe.pathstring-Path for HTTP GET probe.
livenessProbe.initialDelaySecondsinteger-Chart configuration parameter
livenessProbe.periodSecondsinteger-Chart configuration parameter
livenessProbe.timeoutSecondsinteger-Chart configuration parameter
livenessProbe.failureThresholdinteger-Chart configuration parameter

Readiness Probe(6)

ParameterTypeDefaultDescription
readinessProbe.enabledboolean-Enable readiness probe.
readinessProbe.pathstring-Path for HTTP GET probe.
readinessProbe.initialDelaySecondsinteger-Chart configuration parameter
readinessProbe.periodSecondsinteger-Chart configuration parameter
readinessProbe.timeoutSecondsinteger-Chart configuration parameter
readinessProbe.failureThresholdinteger-Chart configuration parameter

Service & Networking(5)

ParameterTypeDefaultDescription
service.typestring-Service type.
Allowed:ClusterIPNodePortLoadBalancer
service.portinteger-HTTP port.
service.annotationsobject-Annotations for the service.
service.ipFamilyPolicystringnull-Service IP family policy.
Allowed:SingleStackPreferDualStackRequireDualStacknull
service.ipFamiliesarray-Service IP families override.

Network Policy(2)

ParameterTypeDefaultDescription
networkPolicy.enabledboolean-Restrict inbound traffic to the Answer HTTP listener.
networkPolicy.extraIngressarray-Optional ingress peers allowed to reach the HTTP listener.

Ingress(5)

ParameterTypeDefaultDescription
ingress.enabledboolean-Enable ingress for Answer.
ingress.ingressClassNamestring-Ingress class name.
ingress.annotationsobject-Ingress annotations.
ingress.hostsarray-Ingress hosts.
ingress.tlsarray-Ingress TLS configuration.

Service Account(4)

ParameterTypeDefaultDescription
serviceAccount.createboolean-Create a dedicated ServiceAccount.
serviceAccount.namestring-Name override (auto-generated if empty).
serviceAccount.annotationsobject-Annotations for the ServiceAccount.
serviceAccount.automountServiceAccountTokenboolean-Mount the Kubernetes API token into the Answer pod.

Gateway(6)

ParameterTypeDefaultDescription
gateway.enabledboolean-Chart configuration parameter
gateway.annotationsobject-Chart configuration parameter
gateway.parentRefsarray-Chart configuration parameter
gateway.hostnamesarray-Chart configuration parameter
gateway.pathstring-Chart configuration parameter
gateway.pathTypestring-Chart configuration parameter
Allowed:ExactPathPrefixRegularExpression

Backup(31)

ParameterTypeDefaultDescription
backup.enabledboolean-Enable scheduled backups to S3-compatible storage.
backup.schedulestring-Cron schedule for backups (default: daily at 03:00 UTC).
backup.suspendboolean-Suspend the CronJob without deleting it.
backup.concurrencyPolicystring-Concurrency policy: Forbid, Replace, Allow.
Allowed:ForbidReplaceAllow
backup.successfulJobsHistoryLimitinteger-Number of successful job records to keep.
backup.failedJobsHistoryLimitinteger-Number of failed job records to keep.
backup.backoffLimitinteger-Maximum retries per backup job.
backup.archivePrefixstring-Prefix for backup archive filenames.
backup.images.sqlitestring-Image used for SQLite backup (must have tar).
backup.images.postgresqlstring-Image used for PostgreSQL backup (must have pg_dump).
backup.images.mysqlstring-Image used for MySQL backup (must have mysqldump).
backup.images.uploaderstring-Image used for S3 upload (MinIO client).
backup.resourcesobject-Resources for backup containers.
backup.s3.endpointstring-S3-compatible endpoint URL.
backup.s3.bucketstring-Target bucket name.
backup.s3.prefixstring-Key prefix within the bucket.
backup.s3.createBucketIfNotExistsboolean-Auto-create the bucket if it does not exist.
backup.s3.existingSecretstring-Use an existing secret for S3 credentials.
backup.s3.existingSecretAccessKeyKeystring-Key in the existing secret for the access key.
backup.s3.existingSecretSecretKeyKeystring-Key in the existing secret for the secret key.
backup.s3.accessKeystring-Inline S3 access key (ignored when existingSecret is set).
backup.s3.secretKeystring-Inline S3 secret key (ignored when existingSecret is set).
backup.database.hoststring-Override database host for backup.
backup.database.portstringinteger-Override database port for backup.
backup.database.namestring-Override database name for backup.
backup.database.usernamestring-Override database username for backup.
backup.database.passwordstring-Override database password for backup.
backup.database.existingSecretstring-Existing secret for backup database credentials.
backup.database.existingSecretPasswordKeystring-Key in existing secret for the backup database password.
backup.database.postgresDumpArgsstring-Extra arguments for pg_dump.
backup.database.mysqlDumpArgsstring-Extra arguments for mysqldump.

Node Selector(1)

ParameterTypeDefaultDescription
nodeSelectorobject-Node selector for pod scheduling.

Tolerations(1)

ParameterTypeDefaultDescription
tolerationsarray-Tolerations for pod scheduling.

Affinity(1)

ParameterTypeDefaultDescription
affinityobject-Affinity rules for pod scheduling.

Topology Spread Constraints(1)

ParameterTypeDefaultDescription
topologySpreadConstraintsarray-Topology spread constraints.

Priority Class Name(1)

ParameterTypeDefaultDescription
priorityClassNamestring-Priority class name.

Termination Grace Period Seconds(1)

ParameterTypeDefaultDescription
terminationGracePeriodSecondsinteger-Grace period for shutdown (seconds).

Pod Labels(1)

ParameterTypeDefaultDescription
podLabelsobject-Additional labels for the pod.

Pod Annotations(1)

ParameterTypeDefaultDescription
podAnnotationsobject-Additional annotations for the pod.

Extra Volume Mounts(1)

ParameterTypeDefaultDescription
extraVolumeMountsarray-Additional volume mounts for the Answer container.

Extra Volumes(1)

ParameterTypeDefaultDescription
extraVolumesarray-Additional volumes for the pod.

Extra Manifests(1)

ParameterTypeDefaultDescription
extraManifestsarray-Extra Kubernetes manifests to deploy alongside the chart.

External Secrets(12)

ParameterTypeDefaultDescription
externalSecrets.enabledboolean-Chart configuration parameter
externalSecrets.apiVersionstring-Chart configuration parameter
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
externalSecrets.admin.enabledboolean-Chart configuration parameter
externalSecrets.admin.dataarray-Chart configuration parameter
externalSecrets.database.enabledboolean-Chart configuration parameter
externalSecrets.database.dataarray-Chart configuration parameter
externalSecrets.backup.enabledboolean-Chart configuration parameter
externalSecrets.backup.dataarray-Chart configuration parameter