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_KEYcan 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.
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.
|-----|---------|-------------|
| 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.ingressFromfor 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 SyncedVerified 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
Chiefonboarding 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(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| image.repository | string | docker.io/chiefonboarding/chiefonboarding | ChiefOnboarding container image |
| image.tag | string | "" | Image tag (defaults to v{appVersion}) |
| image.digest | string | - | Immutable image manifest digest |
| image.pullPolicy | string | IfNotPresent | Image pull policy Allowed: AlwaysIfNotPresentNever |
Image Pull Secrets(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| imagePullSecrets | array | - | Image pull secrets for private registries |
Chiefonboarding(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| chiefonboarding.port | integer | 8000 | Actual Gunicorn listener port |
| chiefonboarding.baseUrl | string | "" | Public base URL of the instance |
| chiefonboarding.allowedHosts | array | - | Host headers accepted by Django |
| chiefonboarding.secretKey | string | "" | Django secret key (auto-generated 50-char alphanumeric if empty) |
| chiefonboarding.existingSecret | string | "" | Existing secret containing the SECRET_KEY key |
| chiefonboarding.existingSecretKey | string | secret-key | Key in the existing secret |
| chiefonboarding.extraEnv | array | - | Extra environment variables for the container |
Database(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| database.external.host | string | "" | Database host |
| database.external.port | stringinteger | 5432 | Database port |
| database.external.name | string | chiefonboarding | Database name |
| database.external.username | string | chiefonboarding | Database username |
| database.external.password | string | "" | Database password |
| database.external.existingSecret | string | "" | Existing secret containing the database password |
| database.external.existingSecretPasswordKey | string | password | Key in the existing secret containing the password |
Service Account(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| serviceAccount.create | boolean | false | Create a ServiceAccount |
| serviceAccount.name | string | "" | ServiceAccount name |
| serviceAccount.annotations | object | - | Annotations for the ServiceAccount |
| serviceAccount.automountServiceAccountToken | boolean | false | Mount the Kubernetes API token into the application pod |
Service & Networking(3)
| Parameter | Type | Default | Description |
|---|---|---|---|
| service.type | string | ClusterIP | Service type Allowed: ClusterIPNodePortLoadBalancer |
| service.port | integer | 80 | HTTP service port |
| service.annotations | object | - | Annotations for the Service |
Ingress(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| ingress.enabled | boolean | false | Enable ingress for ChiefOnboarding |
| ingress.ingressClassName | string | traefik | Ingress class name (for example: traefik, nginx) |
| ingress.annotations | object | - | Annotations for the ingress |
| ingress.hosts | array | - | Ingress hosts |
| ingress.tls | array | - | Ingress TLS configuration |
Health Probes(15)
| Parameter | Type | Default | Description |
|---|---|---|---|
| probes.startup.enabled | boolean | true | 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 | true | 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 | true | 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 |
Resources(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| resources | object | - | CPU and memory requests/limits for the main container |
Pod Security(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| podSecurityContext.seccompProfile.type | string | - | Chart configuration parameter Allowed: RuntimeDefaultLocalhostUnconfined |
Container Security(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| securityContext.allowPrivilegeEscalation | boolean | - | Chart configuration parameter |
| securityContext.capabilities.drop | array | - | Chart configuration parameter |
| securityContext.runAsNonRoot | boolean | - | Chart configuration parameter |
| securityContext.readOnlyRootFilesystem | boolean | - | Chart configuration parameter |
Network Policy(2)
| Parameter | Type | Default | Description |
|---|---|---|---|
| networkPolicy.enabled | boolean | true | Isolate application ingress |
| networkPolicy.ingressFrom | array | - | Additional NetworkPolicy peers allowed to reach the application |
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 | 30 | 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 Volumes(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumes | array | - | Additional volumes for the pod |
Extra Volume Mounts(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraVolumeMounts | array | - | Additional volume mounts for the container |
Extra Manifests(1)
| Parameter | Type | Default | Description |
|---|---|---|---|
| extraManifests | array | - | Extra Kubernetes manifests to deploy alongside the chart |
Postgresql(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| postgresql.enabled | boolean | true | Deploy PostgreSQL as a subchart |
| postgresql.architecture | string | standalone | PostgreSQL architecture |
| postgresql.auth.database | string | chiefonboarding | Chart configuration parameter |
| postgresql.auth.username | string | chiefonboarding | Chart configuration parameter |
| postgresql.auth.password | string | "" | PostgreSQL password (auto-generated if empty) |
| postgresql.auth.existingSecret | string | "" | Existing PostgreSQL Secret managed outside this chart |
| postgresql.auth.existingSecretUserPasswordKey | string | user-password | Application password key in the existing Secret |
No schema parameters match your search
Try searching for a different keyword or reset the filter.