Helm chart to deploy a single-node Garage
(S3-compatible object storage) to Kubernetes. It runs one node with
replication_factor=1 (no clustering/node discovery), keeps upstream security
hardening and optional Prometheus monitoring, and can optionally bootstrap a
bucket + access key on first boot.
The default configuration for this Helm chart is defined in the values.yaml file. For detailed descriptions of all the configurable parameters, refer to the provided values.reference.yaml file. This file serves as the reference for all available settings and their default values. Do not use this for deployment.
A fresh Garage node serves no S3 traffic until it has a cluster layout. By default (garage.singleNode: true) the chart starts Garage with --single-node, and Garage creates the layout itself on first boot. In this mode Garage refuses to start once the layout version is higher than 1, so nothing else may change the layout.
To let the AboutBits Garage Operator manage the layout with a GarageCluster, set garage.singleNode: false. Garage then starts without a layout until the operator applies one. The probes do not use the admin API's /health for this reason: it answers 503 until there is a layout, so a probe on it would keep the Pod out of the Service the operator connects through. They check that Garage answers, not that the cluster can serve requests. bootstrap.enabled needs single-node mode, because Garage accepts --default-bucket only there; create the bucket and the key with the operator's Bucket and AccessKey instead.
You can pull and install the Helm chart directly from the OCI registry.
helm install <release-name> oci://ghcr.io/aboutbits/helm-garage/garage --version <chart-version> --values values-<env>.yaml --namespace <namespace>To build and publish the chart, visit the GitHub Actions page of the repository and trigger the workflow "Release Package" manually.
About Bits is a company based in South Tyrol, Italy. You can find more information about us on our website.
For support, please contact info@aboutbits.it.
The MIT License (MIT). Please see the license file for more information.