CSI Plugin Setup and Configuration
This article details points to consider when setting up and configuring the CSI plugin. Note that when setting up the plugin, the features below require Lightbits release 3.18.1 or newer.
IP-ACL
Lightbits Cluster: IP-ACL enforcement uses the iptables-based firewall on the storage nodes. Enable it at installation time by setting
ipacl_explicit_allow: truein the Ansible inventory.CSI Plugin: Add
ip-acl: enabledto theStorageClassparameters. With thelb-csi-workload-examplesHelm chart, use--set global.storageClass.ipAcl=enabled.
In-Band Authentication
Lightbits Cluster: Enable the feature flag with
lbcli enable feature-flag in-band-authentication, and then turn on in-band authentication withlbcli enable in-band-auth.CSI Plugin: Set
inBandAuth: truein thelb-csiHelm chart values. This requires the discovery-client to run as a container (discoveryClientInContainer: true). With static manifests, deploylb-csi-plugin-k8s-dc-iba.yaml. The setting can also be passed to the plugin with the--inband-authflag orLB_CSI_INBAND_AUTH=true. The plugin checks whether the Lightbits cluster has in-band authentication enabled, but the setting is still needed at deployment time because it changes how the node pod is laid out. If the cluster requires in-band authentication and the plugin was deployed without this setting, volume staging fails with an explicit error.
© 2026 Lightbits Labs™