ScyllaDB University Live | Free Virtual Training Event
Learn more
ScyllaDB Documentation Logo Documentation
  • Deployments
    • Cloud
    • Server
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
    • Supported Driver Versions
  • Resources
    • ScyllaDB University
    • Community Forum
    • Tutorials
Install
Search Ask AI
ScyllaDB Docs ScyllaDB Operator Reference Feature gates

Feature gates¶

ScyllaDB Operator lets you enable or disable features using feature gates. This page lists the available feature gates and explains how to configure them.

Configuring feature gates¶

Feature gates are set with the --feature-gates command-line argument of ScyllaDB Operator. The value is a comma-separated list of <gate>=<bool> pairs.

For example, to enable both gates:

--feature-gates=AutomaticTLSCertificates=true,BootstrapSynchronisation=true

Modify the ScyllaDB Operator Deployment and add the --feature-gates argument to the container args:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: scylla-operator
  namespace: scylla-operator
spec:
  template:
    spec:
      containers:
      - name: scylla-operator
        args:
        - operator
        - --feature-gates=AutomaticTLSCertificates=true,BootstrapSynchronisation=true

Add the --feature-gates argument through the additionalArgs value in values.yaml:

additionalArgs:
- --feature-gates=AutomaticTLSCertificates=true,BootstrapSynchronisation=true

Available feature gates¶

Feature gate

Default

Last changed

AutomaticTLSCertificates

true

v1.11

BootstrapSynchronisation

false

v1.19

  • Default — whether the feature is enabled when you don’t set it explicitly.

  • Last changed — the Operator version in which the feature gate was introduced or its default was changed.

AutomaticTLSCertificates¶

Enables automated TLS certificate provisioning for ScyllaDB clusters. When enabled, the Operator generates and rotates serving and client TLS certificates and configures ScyllaDB nodes to use them for encrypted client-to-node CQL communication (mTLS).

Client certificates are validated by ScyllaDB nodes (the certificate chain must be trusted), but ScyllaDB does not perform client identity or authorization checks based on certificate contents.

See Security — ScyllaDB cluster TLS for the full certificate architecture, and Connect via CQL for client configuration.

Caution

mTLS for node-to-node communication is not yet supported.

BootstrapSynchronisation¶

Caution

This feature requires ScyllaDB ≥ 2025.2.0. The Operator checks the container image version and only adds the bootstrap-barrier init container when the version satisfies this requirement.

Automates ensuring that no nodes are down when a new ScyllaDB node bootstraps. The Operator verifies the status of all existing nodes in the cluster and blocks the new node’s startup until every node is confirmed healthy.

See Bootstrap synchronisation for details on the mechanism.

Was this page helpful?

PREVIOUS
ScyllaOperatorConfig (scylla.scylladb.com/v1alpha1)
NEXT
IPv6 configuration reference
  • Create an issue
  • Edit this page

On this page

  • Feature gates
    • Configuring feature gates
    • Available feature gates
      • AutomaticTLSCertificates
      • BootstrapSynchronisation
ScyllaDB Operator
Search Ask AI
  • v1.21
    • master
    • v1.21
    • v1.20
    • v1.19
    • v1.18
  • Get Started
    • What Is ScyllaDB Operator?
    • ScyllaDB Concepts on Kubernetes
  • Install Operator
    • Provision infrastructure
      • Set up a GKE cluster for ScyllaDB
      • Set up an EKS cluster for ScyllaDB
      • Set up an OKE cluster for ScyllaDB
      • Set up an OpenShift cluster for ScyllaDB
    • Install with GitOps
    • Install with Helm
    • Install on OpenShift
  • Deploy ScyllaDB
    • Before you deploy
      • Set up dedicated node pools
      • Configure CPU pinning
      • Configure nodes
      • Configure ScyllaDB Operator
    • Deploy your first cluster
    • Reference deployments
      • Reference deployment: GKE
      • Reference deployment: EKS
      • Reference deployment: OKE
      • Reference deployment: OpenShift
    • Install ScyllaDB Manager
    • Set up networking
      • Configure external access
      • IPv6 networking
        • Getting started with IPv6 networking
        • Configure dual-stack networking
        • Configure IPv6-only networking
        • Migrate clusters to IPv6
        • Troubleshoot IPv6 networking issues
        • IPv6 networking concepts
    • Set up monitoring
      • Set up ScyllaDB Monitoring
      • Set up ScyllaDB Monitoring on OpenShift
      • Expose Grafana
    • Production checklist
  • Connect Your App
    • Connect via CQL
    • Alternator (DynamoDB API)
    • Discovery endpoint
  • Understand
    • Storage
    • Tuning
    • ScyllaDB Manager
    • Networking
    • ScyllaDB Monitoring overview
    • Bootstrap synchronisation
    • Automatic data cleanup
    • Sidecar and pod anatomy
    • Ignition
    • Pod disruption budgets
    • Security
    • StatefulSets and racks
  • Operate
    • Scale, add, remove racks
    • Replace nodes
    • Expand storage volumes
    • Use maintenance mode
    • Back up and restore
    • Restore from backup
    • Perform a rolling restart
    • Migrate a rack to a new node pool
    • Pass additional ScyllaDB arguments
    • Configure precomputed IO properties
  • Upgrade
    • Upgrading ScyllaDB Operator
    • Upgrading ScyllaDB clusters
  • Troubleshoot
    • Investigate pod restarts
    • Change log level on a live cluster
    • Recover from a failed node replace
    • Troubleshoot performance
    • Collect debugging information
      • Collect data with must-gather
      • must-gather contents
      • Query system tables for debugging
    • Collect core dumps
  • Reference
    • API Reference
      • scylla.scylladb.com
        • NodeConfig (scylla.scylladb.com/v1alpha1)
        • RemoteKubernetesCluster (scylla.scylladb.com/v1alpha1)
        • RemoteOwner (scylla.scylladb.com/v1alpha1)
        • ScyllaCluster (scylla.scylladb.com/v1)
        • ScyllaDBCluster (scylla.scylladb.com/v1alpha1)
        • ScyllaDBDatacenterNodesStatusReport (scylla.scylladb.com/v1alpha1)
        • ScyllaDBDatacenter (scylla.scylladb.com/v1alpha1)
        • ScyllaDBManagerClusterRegistration (scylla.scylladb.com/v1alpha1)
        • ScyllaDBManagerTask (scylla.scylladb.com/v1alpha1)
        • ScyllaDBMonitoring (scylla.scylladb.com/v1alpha1)
        • ScyllaOperatorConfig (scylla.scylladb.com/v1alpha1)
    • Feature gates
    • IPv6 configuration reference
    • Releases
    • Known issues
    • Conditions reference
    • nodetool alternatives
  • Contributing to ScyllaDB Operator
Docs Tutorials University Contact Us About Us
© 2026, ScyllaDB. All rights reserved. | Terms of Service | Privacy Policy | ScyllaDB, and ScyllaDB Cloud, are registered trademarks of ScyllaDB, Inc.
Last updated on 22 May 2026.
Powered by Sphinx 9.1.0 & ScyllaDB Theme 1.9.2