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 Cloud Configure Network Access Configure VPC Peering Configure Virtual Private Cloud (VPC) Peering with AWS
For AI agents: a documentation index is available at https://cloud.docs.scylladb.com/master/llms.txt. A Markdown version of this page is at https://cloud.docs.scylladb.com/master/cluster-connections/vpc-peering/aws-vpc-peering.md.

Configure Virtual Private Cloud (VPC) Peering with AWS¶

ScyllaDB Cloud allows you to connect your application’s private network directly to the ScyllaDB clusters’ private network by using AWS VPC peering. By following this guide, you will better secure your customer’s data and make sure all traffic between Scylla’s cluster and the application layer is being done via a private network and never traverses the public internet.

For more information on AWS VPC peering and its security advantages, see the AWS documentation.

If you are running ScyllaDB Cloud on GCP, refer to Configure Virtual Private Cloud (VPC) Peering with GCP.

Setup AWS VPC Peering¶

Procedure

  1. When creating a cluster, select the Pivate Connection option under Network Types.

    In the CIDR for ScyllaDB Cloud Network field, you can specify the private network block for the cluster (in CIDR format). The default is 172.31.0.0/24. The allowed CIDR blocks are all ranges from RFC 1918:

    • 10.0.0.0/8

    • 172.16.0.0/12 – with the exception of 172.17.0.0/16 (reserved for the ScyllaDB Cloud infrastructure).

    • 192.168.0.0/16

  2. Once the cluster is created, click Setup VPC Peering. This opens a wizard. The first stage is Step 1. Request.

  3. In the AWS Details section, fill in the VPC peering information needed giving the details of your AWS console.

    Include the following details, and click Submit VPC Peering Request when done.

    • Data Center - The name of the data center for the ScyllaDB cluster.

    • AWS Account ID - The account ID number for the Private Network you plan to peer in AWS. To find your account ID, from your AWS console, navigate to support> support center.

    • VPC ID - The application VPC ID which you plan to peer with.

    • VPC Network - The IPv4 CIDR blocks used by your application in this VPC.

      • Your VPC can use private IPv4 ranges (RFC 1918), shared address space (100.64.0.0/10), or public IPv4 ranges supported by AWS.

      • Enter only ranges configured in the VPC you are peering. ScyllaDB Cloud adds routes for the ranges you enter, so incorrect ranges can interrupt access to external services.

      • The blocks must not overlap any network in your ScyllaDB cluster, including the block you’ve set when creating the cluster.

      • Your own VPC may use 172.17.0.0/16 as long as it does not overlap any cluster network. AWS recommends avoiding this range where possible because services such as Cloud9 and SageMaker can use it internally; see AWS IPv4 CIDR considerations.

      • CIDRs must not overlap with 0.0.0.0/8, 127.0.0.0/8, 169.254.0.0/16, 224.0.0.0/4, or 255.255.255.255/32.

      • If there are multiple CIDR blocks in your VPC, list them all separated by commas.

    • VPC Region - Select the region your VPC is set in.

    If you select Add your VPC network addresses to the cluster’s allowed address list, new firewall rules normally require a /16 or more specific prefix.

  4. You will see the next phase in the wizard Step 2. Accept. The page named Setting up VPC Peering is a customized page based on your AWS VPC details and the ScyllaDB Cloud information you already entered. Follow each step on this page. Make sure to copy/paste the Peering Connection ID where indicated.

    Alternatively, you can use the AWS CLI to complete the peering (using the peering connection ID you copied):

    aws ec2 accept-vpc-peering-connection --vpc-peering-connection-id pcx-XXXXXXXXXXXXXXXXXX
    

    When all steps have been completed, click Connect. This brings you to Step 3. Route.

  5. The next phase in the wizard is Step 3. Route. The page named VPC Peering Route Configuration is a customized page with VPC peering route configuration. Follow each step on this page. Make sure you use the specific VPC ID and CIDR Block, as they are based on your settings.

    Alternatively, you can use the AWS CLI for every route table you wish to connect:

    aws ec2 create-route --route-table-id rtb-XXXXXXXXXXXXXXXXXX --vpc-peering-connection-id pcx-XXXXXXXXXXXXXXXXXX --destination-cidr-block 172.31.0.0/24
    

    The above example assumes your cluster was created with the default CIDR (172.31.0.0/24). If you set a different CIDR during cluster creation, make sure you modify the command accordingly.

    Once you have successfully tested and confirmed connectivity, click Done.

Was this page helpful?

PREVIOUS
Configure VPC Peering
NEXT
Configure Virtual Private Cloud (VPC) Peering with GCP
  • Create an issue

On this page

  • Configure Virtual Private Cloud (VPC) Peering with AWS
    • Setup AWS VPC Peering
ScyllaDB Cloud
Search Ask AI
  • Get Started
    • What Is ScyllaDB Cloud?
    • Free Trial
    • Quick Start Guide
    • Billing and Pricing
  • Create & Connect to Your Cluster
    • Deployment Overview
    • Configure and Launch a Cluster
    • Connect to Your Cluster
    • X Cloud Autoscaling Behavior and Best Practices
    • Deploy to Your Own AWS Account (BYOA)
    • Deploy to Your Own GCP Account (BYOA)
    • Configure Availability Zones
    • Cluster Setup Best Practices
    • Standard Clusters
  • Configure Network Access
    • Network Access Options
    • Configure AWS Transit Gateway (TGW) VPC Attachment Connection
    • Configure VPC Peering
      • VPC Peering with AWS
      • VPC Peering with GCP
    • Configure Private Connectivity
      • Private Connectivity with AWS
        • Configure AWS PrivateLink in ScyllaDB Cloud
        • Connect Your AWS VPC to ScyllaDB Cloud
      • Private Connectivity with GCP
        • Configure GCP Private Service Connect in ScyllaDB Cloud
        • Connect Your GCP VPC to ScyllaDB Cloud
    • Migrate a Cluster Connection
    • Check Cluster Availability
    • Glossary for Cluster Connections
  • Operate and Manage Clusters
    • Resize a Cluster
    • Add a Datacenter
    • Delete a Cluster
    • Configure Maintenance Windows
    • Configure Notifications
    • Track Resource Usage
    • Monitor Clusters
    • Monitor with Prometheus
    • Backups
  • Use ScyllaDB
    • Application Best Practices
    • Apache Cassandra Query Language (CQL)
    • ScyllaDB Drivers
    • Data Modeling
    • Tracing
    • Change Data Capture (CDC)
    • Role Based Access Control (RBAC)
    • ScyllaDB Alternator (DynamoDB-compatible API)
    • Lightweight Transactions (LWT)
    • ScyllaDB Integrations
  • Security
    • Security Best Practices
    • Security Concepts
    • Database-level Encryption
    • Storage-level Encryption
    • Client-to-node Encryption
    • Service Users
    • User Management
    • SAML Single Sign-On (SSO)
    • Immutable (WORM) Backups
    • Data Privacy and Compliance
  • Vector and Text Search
    • Quick Start Guide
    • Vector and Text Search Concepts
    • Vector and Text Search Deployments
    • Sizing and Capacity Planning
    • Working with Vector and Text Search
    • Working with Full Text Search
    • Vector Search with Alternator
    • Filtering
    • Quantization and Rescoring
    • LangChain and CassIO Compatibility
    • Security
    • Troubleshooting
    • FAQ
    • Glossary
    • Reference
    • Example Project
  • Cost Optimization
    • Cost Optimization Overview
    • Advanced Internode (RPC) Compression
    • Datacenter Placement and Data Transfer Costs
  • Automate with the ScyllaDB Cloud API
    • Programmatic Access Overview
    • Create a Personal Token for Authentication
    • API Reference
    • API Error Codes
    • Terraform Provider for ScyllaDB Cloud
    • ScyllaDB Cloud MCP Server
  • Get Help
    • FAQ
    • Tutorials
    • Getting Help
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 16 Oct 2026.
Powered by Sphinx 9.1.0 & ScyllaDB Theme 1.9.3