Skip to content
Chiefonboarding icon
v1.1.20App: v2.5.0Pinned DigestS3 Backup Ready

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

ChiefOnboarding Helm Chart

Deploy ChiefOnboarding on Kubernetes using the official chiefonboarding/chiefonboarding container image.

ChiefOnboarding is an employee onboarding automation platform for preboarding, task management, and new hire workflows.

Features

  • Employee onboarding automation - preboarding, task management, workflows
  • Django-based - single application container
  • PostgreSQL backend - bundled subchart or external database
  • Auto-generated secrets - Django SECRET_KEY can be generated by the chart
  • Database wait initContainer - waits for PostgreSQL before app startup
  • Ingress support - TLS with cert-manager, traefik, or nginx
  • Immutable image - official 2.5.0 image pinned by manifest digest
  • Secure pod baseline - seccomp, dropped capabilities, no privilege escalation, and no Kubernetes API token
  • Ingress isolation - NetworkPolicy enabled by default

Installation

HTTPS repository:

helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install chiefonboarding helmforge/chiefonboarding -f values.yaml

OCI registry:

helm install chiefonboarding oci://ghcr.io/helmforgedev/helm/chiefonboarding -f values.yaml

Basic Example

# values.yaml - bundled PostgreSQL
chiefonboarding:
  baseUrl: http://localhost:8000
  allowedHosts:
    - localhost
    - 127.0.0.1
  secretKey: "replace-with-a-stable-django-secret-key"

After deploying, access ChiefOnboarding:

kubectl port-forward svc/<release>-chiefonboarding 8000:80
# Open http://localhost:8000

External Database

postgresql:
  enabled: false

database:
  external:
    host: postgres.example.com
    name: chiefonboarding
    username: chiefonboarding
    existingSecret: chiefonboarding-db-credentials

Application and Service ports

chiefonboarding.port configures the real Gunicorn listener in the official Supervisor configuration. service.port is the independent client-facing cluster port and targets the named http container port:

chiefonboarding:
  port: 9080

service:
  port: 8080

The custom-port k3d scenario sends a real HTTP request to the overridden listener. Changing only service.port does not change the application process.

Upgrading to 2.5.0

Upstream 2.5.0 adds access reports and CSV exports, external user-ID backfill, pagination fixes, and background offboarding account checks. Back up PostgreSQL and preserve the Django secret before upgrading; startup applies the application migrations. Update custom integration manifests for user-ID lookup before using backfill.

Presigned S3 uploads remain the upstream default. The optional AWS_USE_PRESIGNED_UPLOADS=False environment variable routes uploads through the server; account for proxy timeouts and upload limits. AWS_CDN_URL optionally sets the download URL base. Configure these through chiefonboarding.extraEnv, with S3 credentials from Secrets. Existing ports, database configuration and deployment topology are unchanged.

Architecture Guides

Examples

Ingress

ingress:
  enabled: true
  ingressClassName: traefik
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt
  hosts:
    - host: onboarding.example.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - hosts:
        - onboarding.example.com
      secretName: chiefonboarding-tls

The ingressClassName defaults to traefik but nginx or any other supported ingress class can also be used.

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

|-----|---------|-------------| | chiefonboarding.port | 8000 | Application port (Django) | | chiefonboarding.baseUrl | "" | Public base URL of the instance | | chiefonboarding.allowedHosts | localhost and 127.0.0.1 | Django Host headers; add the public hostname | | chiefonboarding.secretKey | "" | Django secret key (auto-generated) | | postgresql.enabled | true | Deploy PostgreSQL subchart | | database.external.host | "" | External PostgreSQL host | | database.external.existingSecret | "" | Existing database password Secret | | ingress.enabled | false | Enable ingress | | service.port | 80 | Service port | | image.digest | pinned 2.5.0 digest | Immutable official image manifest | | serviceAccount.automountServiceAccountToken | false | Mount the Kubernetes API token | | networkPolicy.enabled | true | Isolate application ingress |

Security Scan

Security Scan:

Kubescape 4.0.14 scan of default rendered manifests for MITRE,NSA,SOC2 on 2026-09-15:

Framework Score
MITRE 100.00%
NSA 75.00%
SOC2 90.00%
Aggregate resource score 83.33%

Expected follow-up hardening is operator-dependent:

  • Set explicit CPU and memory requests and limits.
  • Preserve the default seccomp, capability-drop, privilege-escalation, and service-account-token controls.
  • Use existing Secrets for Django and database credentials in production.
  • Configure networkPolicy.ingressFrom for ingress controllers outside the release namespace.

The upstream image runs Supervisor, Gunicorn, and Django Q as root and writes static and process-state files during startup. Consequently, non-root execution and a read-only root filesystem are documented compatibility exceptions. The chart does not pretend those controls are enabled.

Operations and troubleshooting

The generated Django secret key is retained with lookup and Helm's keep policy. Back up that Secret with PostgreSQL. After rotating data inside an externally managed application or database Secret, restart the Deployment; Helm cannot detect data-only changes in external Secrets.

Use these first-response commands:

kubectl -n <namespace> rollout status deployment/<release>-chiefonboarding
kubectl -n <namespace> logs deployment/<release>-chiefonboarding -c wait-for-db
kubectl -n <namespace> logs deployment/<release>-chiefonboarding -c chiefonboarding
kubectl -n <namespace> get events --sort-by=.lastTimestamp

See the operations guide for backup, upgrades, Secret rotation, NetworkPolicy, and incident evidence.

More Information

System Architecture

DESIGN.md Synced

Verified architecture contract rendered dynamically from GitHub DESIGN.md

flowchart LR
  Client[Operator or ingress controller] --> Service[ChiefOnboarding Service]
  Service --> App[ChiefOnboarding pod]
  App --> Web[Gunicorn web process]
  App --> Queue[Django Q scheduler]
  App --> Database[(PostgreSQL)]
  App -. optional .-> Integrations[SMTP, Slack, OIDC, and S3]
  Secret[Application and database Secrets] --> App
Official Contractvalues.schema.json

Chiefonboarding Values Schema Reference

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

76 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(4)

ParameterTypeDefaultDescription
image.repositorystringdocker.io/chiefonboarding/chiefonboardingChiefOnboarding container image
image.tagstring""Image tag (defaults to v{appVersion})
image.digeststring-Immutable image manifest digest
image.pullPolicystringIfNotPresentImage pull policy
Allowed:AlwaysIfNotPresentNever

Image Pull Secrets(1)

ParameterTypeDefaultDescription
imagePullSecretsarray-Image pull secrets for private registries

Chiefonboarding(7)

ParameterTypeDefaultDescription
chiefonboarding.portinteger8000Actual Gunicorn listener port
chiefonboarding.baseUrlstring""Public base URL of the instance
chiefonboarding.allowedHostsarray-Host headers accepted by Django
chiefonboarding.secretKeystring""Django secret key (auto-generated 50-char alphanumeric if empty)
chiefonboarding.existingSecretstring""Existing secret containing the SECRET_KEY key
chiefonboarding.existingSecretKeystringsecret-keyKey in the existing secret
chiefonboarding.extraEnvarray-Extra environment variables for the container

Database(7)

ParameterTypeDefaultDescription
database.external.hoststring""Database host
database.external.portstringinteger5432Database port
database.external.namestringchiefonboardingDatabase name
database.external.usernamestringchiefonboardingDatabase username
database.external.passwordstring""Database password
database.external.existingSecretstring""Existing secret containing the database password
database.external.existingSecretPasswordKeystringpasswordKey in the existing secret containing the password

Service Account(4)

ParameterTypeDefaultDescription
serviceAccount.createbooleanfalseCreate a ServiceAccount
serviceAccount.namestring""ServiceAccount name
serviceAccount.annotationsobject-Annotations for the ServiceAccount
serviceAccount.automountServiceAccountTokenbooleanfalseMount the Kubernetes API token into the application pod

Service & Networking(3)

ParameterTypeDefaultDescription
service.typestringClusterIPService type
Allowed:ClusterIPNodePortLoadBalancer
service.portinteger80HTTP service port
service.annotationsobject-Annotations for the Service

Ingress(5)

ParameterTypeDefaultDescription
ingress.enabledbooleanfalseEnable ingress for ChiefOnboarding
ingress.ingressClassNamestringtraefikIngress class name (for example: traefik, nginx)
ingress.annotationsobject-Annotations for the ingress
ingress.hostsarray-Ingress hosts
ingress.tlsarray-Ingress TLS configuration

Health Probes(15)

ParameterTypeDefaultDescription
probes.startup.enabledbooleantrueChart 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.enabledbooleantrueChart 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.enabledbooleantrueChart 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

Resources(1)

ParameterTypeDefaultDescription
resourcesobject-CPU and memory requests/limits for the main container

Pod Security(1)

ParameterTypeDefaultDescription
podSecurityContext.seccompProfile.typestring-Chart configuration parameter
Allowed:RuntimeDefaultLocalhostUnconfined

Container Security(4)

ParameterTypeDefaultDescription
securityContext.allowPrivilegeEscalationboolean-Chart configuration parameter
securityContext.capabilities.droparray-Chart configuration parameter
securityContext.runAsNonRootboolean-Chart configuration parameter
securityContext.readOnlyRootFilesystemboolean-Chart configuration parameter

Network Policy(2)

ParameterTypeDefaultDescription
networkPolicy.enabledbooleantrueIsolate application ingress
networkPolicy.ingressFromarray-Additional NetworkPolicy peers allowed to reach the application

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
terminationGracePeriodSecondsinteger30Grace 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 Volumes(1)

ParameterTypeDefaultDescription
extraVolumesarray-Additional volumes for the pod

Extra Volume Mounts(1)

ParameterTypeDefaultDescription
extraVolumeMountsarray-Additional volume mounts for the container

Extra Manifests(1)

ParameterTypeDefaultDescription
extraManifestsarray-Extra Kubernetes manifests to deploy alongside the chart

Postgresql(7)

ParameterTypeDefaultDescription
postgresql.enabledbooleantrueDeploy PostgreSQL as a subchart
postgresql.architecturestringstandalonePostgreSQL architecture
postgresql.auth.databasestringchiefonboardingChart configuration parameter
postgresql.auth.usernamestringchiefonboardingChart configuration parameter
postgresql.auth.passwordstring""PostgreSQL password (auto-generated if empty)
postgresql.auth.existingSecretstring""Existing PostgreSQL Secret managed outside this chart
postgresql.auth.existingSecretUserPasswordKeystringuser-passwordApplication password key in the existing Secret