Was this page helpful?
Caution
You're viewing documentation for an unstable version of ScyllaDB Operator. Switch to the latest stable version.
IPv6 networking¶
IPv6 networking support enables you to run ScyllaDB clusters on IPv6 networks, with options for IPv6-only, IPv4-only, or dual-stack (both protocols) configurations.
Note
IPv6-only configurations are experimental. All other configurations are production-ready. See Production readiness for details.
Tutorials¶
Start here if you’re new to IPv6 networking in ScyllaDB:
Getting started with IPv6 networking - Your first IPv6-enabled cluster with step-by-step guidance
How-to guides¶
Practical guides for specific tasks:
Configure dual-stack with IPv4 - IPv4-first dual-stack (recommended)
Configure dual-stack with IPv6 - IPv6-first dual-stack
Configure IPv6-only - IPv6 single-stack (experimental)
Migrate clusters to IPv6 - Migrate existing clusters from IPv4 to IPv6
Troubleshoot IPv6 networking issues - Diagnose and resolve common problems
Reference¶
Technical specifications and API details:
IPv6 configuration reference - Complete API reference for IPv6 settings
Concepts¶
Deep explanations of how IPv6 networking works:
IPv6 networking concepts - Understand how IPv6 support works in ScyllaDB
Configuration examples¶
Quick examples for common scenarios:
Dual-stack (recommended for production):
network:
ipFamilyPolicy: PreferDualStack
ipFamilies:
- IPv4 # ScyllaDB uses IPv4
- IPv6 # Services also support IPv6
dnsPolicy: ClusterFirst
IPv6-only (experimental):
network:
ipFamilyPolicy: SingleStack
ipFamilies:
- IPv6
dnsPolicy: ClusterFirst
IPv4-only (default):
network:
ipFamilyPolicy: SingleStack
ipFamilies:
- IPv4
For complete examples, see the how-to guides.
Key concepts¶
IP family selection¶
The first IP family in network.ipFamilies determines which protocol ScyllaDB uses internally:
[IPv6]→ ScyllaDB uses IPv6[IPv4, IPv6]→ ScyllaDB uses IPv4, services support both[IPv6, IPv4]→ ScyllaDB uses IPv6, services support both
Learn more in IPv6 networking concepts.
Dual-stack behavior¶
“Dual-stack” refers to Kubernetes services having both IPv4 and IPv6 addresses. ScyllaDB itself always runs on a single IP family (the first one configured).
This provides client flexibility while maintaining internal consistency.
DNS configuration¶
For IPv6, dnsPolicy: ClusterFirst is essential to ensure proper DNS resolution of IPv6 addresses.
Prerequisites¶
Before configuring IPv6:
Network: Cluster must have IPv6 networking configured
Feature status¶
Configuration |
Status |
Production Ready |
|---|---|---|
Dual-stack (IPv4 + IPv6) |
Stable |
Yes |
IPv6-only |
Experimental |
No |
IPv4-only |
Stable |
Yes |
For IPv6-only production support progress, see #3211.
Getting help¶
If you need assistance:
Check documentation: Review the troubleshooting guide and concepts
Search issues: Look for similar problems in GitHub issues
Ask the community: Join ScyllaDB Slack
Open an issue: Report bugs or request features on GitHub