alf.io Helm Chart
Deploy alf.io, an open-source event ticketing and attendee management platform, with its official image and PostgreSQL.
Features
- Official alf.io image pinned to
2.0-M5-2609 - Bundled HelmForge PostgreSQL or an external PostgreSQL service
- Real Spring Boot listener configuration independent from the Service port
- Startup, liveness, and readiness checks on
/healthz - Non-root, read-only, capability-free security defaults
- Service-account token disabled and ingress NetworkPolicy enabled by default
- Optional Ingress with TLS configuration
Install
helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install alfio helmforge/alfio \
--set alfio.baseUrl=https://tickets.example.com
The equivalent OCI install is:
helm install alfio oci://ghcr.io/helmforgedev/helm/alfio \
--set alfio.baseUrl=https://tickets.example.com
Access a ClusterIP installation locally:
kubectl port-forward service/alfio-alfio 8080:80
Then open http://localhost:8080. alf.io guides the administrator through
first-time setup.
Production Example
alfio:
baseUrl: https://tickets.example.com
postgresql:
enabled: false
database:
external:
host: postgres.example.com
port: "5432"
name: alfio
username: alfio
existingSecret: alfio-db-credentials
existingSecretPasswordKey: password
ingress:
enabled: true
ingressClassName: nginx
hosts:
- host: tickets.example.com
paths:
- path: /
pathType: Prefix
tls:
- hosts:
- tickets.example.com
secretName: alfio-tls
resources:
requests:
cpu: 250m
memory: 512Mi
limits:
memory: 1Gi
Listener and Service Ports
alfio.containerPort changes the port used by the actual Spring Boot process.
service.port changes only the Kubernetes Service port. The Service always
targets the named application port.
alfio:
containerPort: 8081
service:
port: 9080
Security
The defaults run the official image as UID/GID 1001, drop all capabilities,
disable privilege escalation and API token mounting, enable RuntimeDefault
seccomp, and make the root filesystem read-only. /tmp is the only chart-owned
writable application path. A NetworkPolicy permits inbound traffic only to the
named HTTP listener.
If the cluster CNI does not enforce NetworkPolicy, the object has no traffic effect. Egress remains unrestricted for payment providers, email, webhooks, and external databases. Use an existing Secret for database credentials and keep the release at a patched upstream version.
Security Scan: alfio
| Framework | Score |
|---|---|
| MITRE + NSA + SOC2 | 78.79% |
Security posture includes non-root execution, a read-only root filesystem, disabled token mounting, default ingress isolation, and operator-owned TLS, database, identity, and egress controls.
Architecture
One single-replica Deployment serves the web application and API through a
ClusterIP Service and optional Ingress. A database wait init container gates
startup. PostgreSQL owns all durable state; the application pod and its /tmp
volume are disposable. See the architecture guide for ownership boundaries and
request flow.
Database and Operations
The bundled database is appropriate for evaluation and small installations that accept release-owned database lifecycle. Production platforms should normally use external PostgreSQL with platform backup, restore testing, replication, and maintenance processes.
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.
| --- | --- | --- |
| alfio.containerPort | 8080 | Port used by the Spring Boot process |
| alfio.baseUrl | "" | Public URL used by attendees and administrators |
| alfio.profiles | "jdbc-session" | Additional Spring profiles |
| service.port | 80 | Kubernetes Service port |
| networkPolicy.enabled | true | Restrict inbound traffic to HTTP |
| serviceAccount.automountServiceAccountToken | false | Mount a Kubernetes API token |
| postgresql.enabled | true | Deploy the PostgreSQL subchart |
| ingress.enabled | false | Create an Ingress |
Troubleshooting
kubectl get pods -l app.kubernetes.io/instance=alfio
kubectl logs deployment/alfio-alfio --all-containers --tail=200
kubectl get endpointslices -l kubernetes.io/service-name=alfio-alfio
kubectl get networkpolicy alfio-alfio -o yaml
If startup remains blocked, validate PostgreSQL DNS, port, credentials, and
network reachability. If probes fail after a listener override, confirm that
SERVER_PORT, the named container port, and the Service target are aligned in
the rendered Deployment.
Limitations
- The application is deliberately single-replica.
- The chart does not manage application-level backups, SMTP, payments, WAF, or certificate issuers.
- Operators must test PostgreSQL restores and size resources for sale traffic.
More Information
System Architecture
DESIGN.md SyncedVerified architecture contract rendered dynamically from GitHub DESIGN.md
flowchart LR
client[Browser or API client]
ingress[Ingress]
service[alf.io Service]
subgraph application[alf.io application]
init[Database wait init container]
alfio[alf.io Deployment]
end
subgraph database[Database boundary]
bundled[Bundled PostgreSQL StatefulSet]
external[External PostgreSQL]
end
client -. ingress enabled .-> ingress --> service --> alfio
init --> bundled
init -. external mode .-> external
alfio --> bundled
alfio -. external mode .-> externalAlfio 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 | docker.io/alfio/alf.io | alf.io container image |
| image.tag | string | 2.0-M5-2609 | Pinned alf.io image tag |
| 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 |
Alfio(4)
| Parameter | Type | Default | Description |
|---|---|---|---|
| alfio.containerPort | integer | 8080 | HTTP port used by the alf.io process inside the container |
| alfio.baseUrl | string | "" | Public URL of the alf.io instance (e.g. https://tickets.example.com) |
| alfio.profiles | string | jdbc-session | Additional Spring profiles to activate |
| alfio.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 | alfio | Database name |
| database.external.username | string | alfio | 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 a 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 alf.io |
| 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(18)
| Parameter | Type | Default | Description |
|---|---|---|---|
| probes.startup.enabled | boolean | true | Chart configuration parameter |
| probes.startup.path | string | /healthz | 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.path | string | /healthz | 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.path | string | /healthz | 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(7)
| Parameter | Type | Default | Description |
|---|---|---|---|
| securityContext.allowPrivilegeEscalation | boolean | - | Chart configuration parameter |
| securityContext.readOnlyRootFilesystem | boolean | - | Chart configuration parameter |
| securityContext.runAsGroup | integer | - | Chart configuration parameter |
| securityContext.runAsNonRoot | boolean | - | Chart configuration parameter |
| securityContext.runAsUser | integer | - | Chart configuration parameter |
| securityContext.capabilities.add | array | - | Chart configuration parameter |
| securityContext.capabilities.drop | array | - | Chart configuration parameter |
Network Policy(2)
| Parameter | Type | Default | Description |
|---|---|---|---|
| networkPolicy.enabled | boolean | true | Restrict inbound traffic to the named HTTP listener |
| networkPolicy.extraIngress | array | - | Additional ingress rules appended to the default HTTP rule |
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(5)
| Parameter | Type | Default | Description |
|---|---|---|---|
| postgresql.enabled | boolean | true | Deploy PostgreSQL as a subchart |
| postgresql.architecture | string | standalone | PostgreSQL architecture |
| postgresql.auth.database | string | alfio | Chart configuration parameter |
| postgresql.auth.username | string | alfio | Chart configuration parameter |
| postgresql.auth.password | string | "" | PostgreSQL password (auto-generated if empty) |
No schema parameters match your search
Try searching for a different keyword or reset the filter.