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.1subcharts. - 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
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.
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
- Apache Answer documentation
- Chart design
- Database configuration
- Backup and restore
- Routing
- External Secrets
- Security and network policy
- HelmForge chart source
Security Scan: answer
| Framework | Score |
|---|---|
| MITRE + NSA + SOC2 | 86.580086% |
Security posture: acceptable.
System Architecture
DESIGN.md SyncedVerified 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]
Answer Values Schema Reference
Official schema parameters, default values, and types extracted directly from the chart repository.
Global(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| global | object | - | Global settings shared by the chart. |
Name Override(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| nameOverride | string | - | Override the chart name used in resource names. |
Fullname Override(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| fullnameOverride | string | - | Override the full release name used in resource names. |
Common Labels(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| commonLabels | object | - | Labels added to every resource created by this chart. |
Image(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| image.repository | string | - | Container image repository. |
| image.tag | string | - | Container image tag (defaults to appVersion). |
| image.pullPolicy | string | - | Image pull policy. Allowed: AlwaysIfNotPresentNever |
Image Pull Secrets(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| imagePullSecrets | array | - | Image pull secrets for private registries. |
Answer(10)
| Parameter | Type | Default | Description |
|---|---|---|---|
| answer.siteUrl | string | - | Full external URL of the site (auto-detected from Ingress or Gateway hostname if empty). |
| answer.siteName | string | - | Site name displayed in the browser tab and header. |
| answer.language | string | - | Default language for the UI. |
| answer.contactEmail | string | - | Contact email shown in the site footer and admin. |
| answer.externalContentDisplay | string | - | External content display policy used by Answer auto-install. Allowed: always_displayask_before_display |
| answer.autoInstall | boolean | - | Enable automatic installation via environment variables. |
| answer.logLevel | string | - | Log level: DEBUG, INFO, WARN, ERROR. Allowed: DEBUGINFOWARNERROR |
| answer.notifications.newQuestionEmail.queueSize | integer | - | Maximum number of new-question email tasks buffered by the Answer worker. |
| answer.notifications.newQuestionEmail.sendIntervalSeconds | integer | - | Delay in seconds between new-question email attempts; 0 disables throttling. |
| answer.extraEnv | array | - | Additional environment variables for the Answer container. |
Admin(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| admin.name | string | - | Admin username for initial setup. |
| admin.password | string | - | Admin password (auto-generated if empty and no existingSecret). |
| admin.email | string | - | Admin email address. |
| admin.existingSecret | string | - | Use an existing secret for admin credentials. |
| admin.existingSecretPasswordKey | string | - | Key in the existing secret for the admin password. |
Database(10)
| Parameter | Type | Default | Description |
|---|---|---|---|
| database.mode | string | - | Database mode: auto | sqlite | external | postgresql | mysql. Allowed: autosqliteexternalpostgresqlmysql |
| database.sqlite.file | string | - | SQLite database file path inside the data volume. |
| database.external.vendor | string | - | Database vendor: postgres | mysql. Allowed: postgresmysql |
| database.external.host | string | - | External database hostname. |
| database.external.port | stringinteger | - | External database port (auto-detected from vendor if empty). |
| database.external.name | string | - | Database name. |
| database.external.username | string | - | Database username. |
| database.external.password | string | - | Database password (ignored when existingSecret is set). |
| database.external.existingSecret | string | - | Existing secret for the database password. |
| database.external.existingSecretPasswordKey | string | - | Key in the existing secret for the database password. |
Postgresql(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| postgresql.enabled | boolean | - | Deploy PostgreSQL as a subchart. |
| postgresql.architecture | string | - | PostgreSQL architecture (standalone or replication). |
| postgresql.auth.database | string | - | Database name created on first run. |
| postgresql.auth.username | string | - | Database username created on first run. |
| postgresql.auth.password | string | - | Database password (auto-generated if empty). |
| postgresql.standalone.persistence.enabled | boolean | - | Enable persistence for PostgreSQL data. |
| postgresql.standalone.persistence.size | string | - | PVC size for PostgreSQL. |
Mysql(8)
| Parameter | Type | Default | Description |
|---|---|---|---|
| mysql.enabled | boolean | - | Deploy MySQL as a subchart. |
| mysql.architecture | string | - | MySQL architecture (standalone or replication). |
| mysql.auth.database | string | - | Database name created on first run. |
| mysql.auth.username | string | - | Database username created on first run. |
| mysql.auth.password | string | - | Database password (auto-generated if empty). |
| mysql.auth.rootPassword | string | - | Root password (auto-generated if empty). |
| mysql.standalone.persistence.enabled | boolean | - | Enable persistence for MySQL data. |
| mysql.standalone.persistence.size | string | - | PVC size for MySQL. |
Persistence(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| persistence.enabled | boolean | - | Enable persistent storage for /data. |
| persistence.storageClass | string | - | Storage class (leave empty for cluster default). |
| persistence.accessMode | string | - | Access mode for the PVC. |
| persistence.size | string | - | Size of the persistent volume. |
| persistence.existingClaim | string | - | Use an existing PVC instead of creating one. |
| persistence.annotations | object | - | Annotations for the PVC. |
Resources(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| resources.requests.cpu | stringnumber | - | Chart configuration parameter |
| resources.requests.memory | string | - | Chart configuration parameter |
| resources.limits.cpu | stringnumber | - | Chart configuration parameter |
| resources.limits.memory | string | - | Chart configuration parameter |
Pod Security(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podSecurityContext.runAsNonRoot | boolean | - | Chart configuration parameter |
| podSecurityContext.runAsUser | integer | - | Chart configuration parameter |
| podSecurityContext.runAsGroup | integer | - | Chart configuration parameter |
| podSecurityContext.fsGroup | integer | - | Chart configuration parameter |
| podSecurityContext.fsGroupChangePolicy | string | - | Chart configuration parameter Allowed: AlwaysOnRootMismatch |
| podSecurityContext.seccompProfile.type | string | - | Chart configuration parameter |
Container Security(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| securityContext.allowPrivilegeEscalation | boolean | false | Chart configuration parameter |
| securityContext.readOnlyRootFilesystem | boolean | true | Chart configuration parameter |
| securityContext.capabilities.drop | array | ["ALL"] | Chart configuration parameter |
| securityContext.capabilities.add | array | ["NET_BIND_SERVICE"] | Chart configuration parameter |
Container Ports(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| containerPorts.http | integer | - | HTTP port opened by the Apache Answer process. |
Startup Probe(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| startupProbe.enabled | boolean | - | Enable startup probe. |
| startupProbe.path | string | - | Path for HTTP GET probe. |
| startupProbe.initialDelaySeconds | integer | - | Chart configuration parameter |
| startupProbe.periodSeconds | integer | - | Chart configuration parameter |
| startupProbe.timeoutSeconds | integer | - | Chart configuration parameter |
| startupProbe.failureThreshold | integer | - | Chart configuration parameter |
Liveness Probe(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| livenessProbe.enabled | boolean | - | Enable liveness probe. |
| livenessProbe.path | string | - | Path for HTTP GET probe. |
| livenessProbe.initialDelaySeconds | integer | - | Chart configuration parameter |
| livenessProbe.periodSeconds | integer | - | Chart configuration parameter |
| livenessProbe.timeoutSeconds | integer | - | Chart configuration parameter |
| livenessProbe.failureThreshold | integer | - | Chart configuration parameter |
Readiness Probe(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| readinessProbe.enabled | boolean | - | Enable readiness probe. |
| readinessProbe.path | string | - | Path for HTTP GET probe. |
| readinessProbe.initialDelaySeconds | integer | - | Chart configuration parameter |
| readinessProbe.periodSeconds | integer | - | Chart configuration parameter |
| readinessProbe.timeoutSeconds | integer | - | Chart configuration parameter |
| readinessProbe.failureThreshold | integer | - | Chart configuration parameter |
Service & Networking(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| service.type | string | - | Service type. Allowed: ClusterIPNodePortLoadBalancer |
| service.port | integer | - | HTTP port. |
| service.annotations | object | - | Annotations for the service. |
| service.ipFamilyPolicy | stringnull | - | Service IP family policy. Allowed: SingleStackPreferDualStackRequireDualStacknull |
| service.ipFamilies | array | - | Service IP families override. |
Network Policy(2)
| Parameter | Type | Default | Description |
|---|---|---|---|
| networkPolicy.enabled | boolean | - | Restrict inbound traffic to the Answer HTTP listener. |
| networkPolicy.extraIngress | array | - | Optional ingress peers allowed to reach the HTTP listener. |
Ingress(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| ingress.enabled | boolean | - | Enable ingress for Answer. |
| ingress.ingressClassName | string | - | Ingress class name. |
| ingress.annotations | object | - | Ingress annotations. |
| ingress.hosts | array | - | Ingress hosts. |
| ingress.tls | array | - | Ingress TLS configuration. |
Service Account(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| serviceAccount.create | boolean | - | Create a dedicated ServiceAccount. |
| serviceAccount.name | string | - | Name override (auto-generated if empty). |
| serviceAccount.annotations | object | - | Annotations for the ServiceAccount. |
| serviceAccount.automountServiceAccountToken | boolean | - | Mount the Kubernetes API token into the Answer pod. |
Gateway(6)
| Parameter | Type | Default | Description |
|---|---|---|---|
| gateway.enabled | boolean | - | Chart configuration parameter |
| gateway.annotations | object | - | Chart configuration parameter |
| gateway.parentRefs | array | - | Chart configuration parameter |
| gateway.hostnames | array | - | Chart configuration parameter |
| gateway.path | string | - | Chart configuration parameter |
| gateway.pathType | string | - | Chart configuration parameter Allowed: ExactPathPrefixRegularExpression |
Backup(31)
| Parameter | Type | Default | Description |
|---|---|---|---|
| backup.enabled | boolean | - | Enable scheduled backups to S3-compatible storage. |
| backup.schedule | string | - | Cron schedule for backups (default: daily at 03:00 UTC). |
| backup.suspend | boolean | - | Suspend the CronJob without deleting it. |
| backup.concurrencyPolicy | string | - | Concurrency policy: Forbid, Replace, Allow. Allowed: ForbidReplaceAllow |
| backup.successfulJobsHistoryLimit | integer | - | Number of successful job records to keep. |
| backup.failedJobsHistoryLimit | integer | - | Number of failed job records to keep. |
| backup.backoffLimit | integer | - | Maximum retries per backup job. |
| backup.archivePrefix | string | - | Prefix for backup archive filenames. |
| backup.images.sqlite | string | - | Image used for SQLite backup (must have tar). |
| backup.images.postgresql | string | - | Image used for PostgreSQL backup (must have pg_dump). |
| backup.images.mysql | string | - | Image used for MySQL backup (must have mysqldump). |
| backup.images.uploader | string | - | Image used for S3 upload (MinIO client). |
| backup.resources | object | - | Resources for backup containers. |
| backup.s3.endpoint | string | - | S3-compatible endpoint URL. |
| backup.s3.bucket | string | - | Target bucket name. |
| backup.s3.prefix | string | - | Key prefix within the bucket. |
| backup.s3.createBucketIfNotExists | boolean | - | Auto-create the bucket if it does not exist. |
| backup.s3.existingSecret | string | - | Use an existing secret for S3 credentials. |
| backup.s3.existingSecretAccessKeyKey | string | - | Key in the existing secret for the access key. |
| backup.s3.existingSecretSecretKeyKey | string | - | Key in the existing secret for the secret key. |
| backup.s3.accessKey | string | - | Inline S3 access key (ignored when existingSecret is set). |
| backup.s3.secretKey | string | - | Inline S3 secret key (ignored when existingSecret is set). |
| backup.database.host | string | - | Override database host for backup. |
| backup.database.port | stringinteger | - | Override database port for backup. |
| backup.database.name | string | - | Override database name for backup. |
| backup.database.username | string | - | Override database username for backup. |
| backup.database.password | string | - | Override database password for backup. |
| backup.database.existingSecret | string | - | Existing secret for backup database credentials. |
| backup.database.existingSecretPasswordKey | string | - | Key in existing secret for the backup database password. |
| backup.database.postgresDumpArgs | string | - | Extra arguments for pg_dump. |
| backup.database.mysqlDumpArgs | string | - | Extra arguments for mysqldump. |
Node Selector(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| nodeSelector | object | - | Node selector for pod scheduling. |
Tolerations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| tolerations | array | - | Tolerations for pod scheduling. |
Affinity(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| affinity | object | - | Affinity rules for pod scheduling. |
Topology Spread Constraints(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| topologySpreadConstraints | array | - | Topology spread constraints. |
Priority Class Name(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| priorityClassName | string | - | Priority class name. |
Termination Grace Period Seconds(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| terminationGracePeriodSeconds | integer | - | Grace period for shutdown (seconds). |
Pod Labels(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podLabels | object | - | Additional labels for the pod. |
Pod Annotations(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podAnnotations | object | - | Additional annotations for the pod. |
Extra Volume Mounts(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumeMounts | array | - | Additional volume mounts for the Answer container. |
Extra Volumes(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumes | array | - | Additional volumes for the pod. |
Extra Manifests(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraManifests | array | - | Extra Kubernetes manifests to deploy alongside the chart. |
External Secrets(12)
| Parameter | Type | Default | Description |
|---|---|---|---|
| externalSecrets.enabled | boolean | - | Chart configuration parameter |
| externalSecrets.apiVersion | string | - | Chart configuration parameter |
| 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 |
| externalSecrets.admin.enabled | boolean | - | Chart configuration parameter |
| externalSecrets.admin.data | array | - | Chart configuration parameter |
| externalSecrets.database.enabled | boolean | - | Chart configuration parameter |
| externalSecrets.database.data | array | - | Chart configuration parameter |
| externalSecrets.backup.enabled | boolean | - | Chart configuration parameter |
| externalSecrets.backup.data | array | - | Chart configuration parameter |
No schema parameters match your search
Try searching for a different keyword or reset the filter.