Skip to content
Alfio icon
v1.2.17App: v2.0-M5-2609Pinned DigestS3 Backup Ready

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

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.

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

| --- | --- | --- | | 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 Synced

Verified 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 .-> external
Official Contractvalues.schema.json

Alfio 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(3)

ParameterTypeDefaultDescription
image.repositorystringdocker.io/alfio/alf.ioalf.io container image
image.tagstring2.0-M5-2609Pinned alf.io image tag
image.pullPolicystringIfNotPresentImage pull policy
Allowed:AlwaysIfNotPresentNever

Image Pull Secrets(1)

ParameterTypeDefaultDescription
imagePullSecretsarray-Image pull secrets for private registries

Alfio(4)

ParameterTypeDefaultDescription
alfio.containerPortinteger8080HTTP port used by the alf.io process inside the container
alfio.baseUrlstring""Public URL of the alf.io instance (e.g. https://tickets.example.com)
alfio.profilesstringjdbc-sessionAdditional Spring profiles to activate
alfio.extraEnvarray-Extra environment variables for the container

Database(7)

ParameterTypeDefaultDescription
database.external.hoststring""Database host
database.external.portstringinteger5432Database port
database.external.namestringalfioDatabase name
database.external.usernamestringalfioDatabase 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 a 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 alf.io
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(18)

ParameterTypeDefaultDescription
probes.startup.enabledbooleantrueChart configuration parameter
probes.startup.pathstring/healthzChart 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.pathstring/healthzChart 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.pathstring/healthzChart 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(7)

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

Network Policy(2)

ParameterTypeDefaultDescription
networkPolicy.enabledbooleantrueRestrict inbound traffic to the named HTTP listener
networkPolicy.extraIngressarray-Additional ingress rules appended to the default HTTP rule

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(5)

ParameterTypeDefaultDescription
postgresql.enabledbooleantrueDeploy PostgreSQL as a subchart
postgresql.architecturestringstandalonePostgreSQL architecture
postgresql.auth.databasestringalfioChart configuration parameter
postgresql.auth.usernamestringalfioChart configuration parameter
postgresql.auth.passwordstring""PostgreSQL password (auto-generated if empty)