Launch ScyllaDB on AWS¶

Launching Instances from ScyllaDB AMI¶

1. Choose your region, and click the Node link to open the EC2 instance creation wizard.

   The following table shows the latest patch release. See AWS Images for earlier releases.

   2025.4.0¶

   View image details

   Region	x86 AMI ID	Launch x86	ARM AMI ID	Launch ARM
   Asia Pacific (Hyderabad)	ami-0f2e295e32ef6fffc	Node	ami-0b7ba3cf24cac824e	Node
   Africa (Cape Town)	ami-050e95081e554d2af	Node	ami-034d59348efbfd5c3	Node
   Asia Pacific (Mumbai)	ami-09d41fb80834ae89f	Node	ami-04658a930b9f18092	Node
   Europe (Stockholm)	ami-02f8abb6f8482d004	Node	ami-0682638d0af427469	Node
   Europe (Paris)	ami-060f9242fc3e4f1a7	Node	ami-0610f8b4222e73ce2	Node
   Europe (Milan)	ami-040ea42e2c784c530	Node	ami-076cb0c2786f29712	Node
   Europe (London)	ami-080a105fdb6c7307a	Node	ami-03857d54020c53ae5	Node
   Europe (Ireland)	ami-04d71b0dd8bbe2829	Node	ami-01b9042b85bda0bd7	Node
   Asia Pacific (Osaka)	ami-052f51113e68096f3	Node	ami-00ee5c1e8d0d78103	Node
   Asia Pacific (Seoul)	ami-0367d7f94879b64c6	Node	ami-015606de4690e3cc4	Node
   Middle East (Bahrain)	ami-0d812f353d25ffb96	Node	ami-0314ac02e3c442075	Node
   Asia Pacific (Tokyo)	ami-0ae3a4714f5417a8c	Node	ami-0ba9619578b1185e7	Node
   Israel (Tel Aviv)	ami-0abbe4252190b74a9	Node	ami-0a9a3cff3bf578a68	Node
   Canada (Central)	ami-0407274b01ed572bb	Node	ami-076d0890977232dd1	Node
   South America (Sao Paulo)	ami-067b97ce3abf9d84f	Node	ami-0256f4a9921fdb319	Node
   Asia Pacific (Hong Kong)	ami-072967f18c2f047c6	Node	ami-0648eec997375caa9	Node
   Asia Pacific (Singapore)	ami-0e0f7d8649630dbaa	Node	ami-05cdac8942f2d8bd2	Node
   Asia Pacific (Sydney)	ami-0862a9979c13245b1	Node	ami-00f293fb5ae36dc89	Node
   Europe (Frankfurt)	ami-04eb3ed8234ede385	Node	ami-014f325a4b8b945ba	Node
   US East (N. Virginia)	ami-049fe2c8978bc5908	Node	ami-040a69957aa075013	Node
   US East (Ohio)	ami-053cf984a41f606b8	Node	ami-0d7837f749aa6c670	Node
   US West (N. California)	ami-07e69240f8276d6fa	Node	ami-0b9bdb177a6206e19	Node
   US West (Oregon)	ami-0a57d3c2e2a64d432	Node	ami-01463c9a5b96a5b50	Node

2. Choose the instance type. See Cloud Instance Recommendations for AWS for the list of recommended instances.

   Other instance types will work, but with lesser performance. If you choose an instance type other than the recommended ones, make sure to run the scylla_setup script.

3. Configure your instance details.

   • Number of instances – If you are launching more than one instance, make sure to correctly set the IP of the first instance with the seeds parameter - either in the User Data (see below) or after launch.

   • Network – Configure the network settings.

     • Select your VPC.

     • Configure the security group. Ensure that all ScyllaDB ports are open.

   • Advanced Details> User Data – Here, you can add ScyllaDB configuration options in the JSON format. See scylla.yaml for information about supported options.

     The following example shows a configuration using the most popular options.

     • cluster_name - The name of the cluster.

     • seed_provider - The IP of the first node. New nodes will use the IP of this seed node to connect to the cluster and learn the cluster topology and state. See ScyllaDB Seed Nodes.

     • post_configuration_script - A base64 encoded bash script that will be executed after the configuration is completed.

     • start_scylla_on_first_boot - Starts ScyllaDB once the configuration is completed.

     Example:

     {
          "scylla_yaml": {
              "cluster_name": "test-cluster",
              "seed_provider": [{"class_name": "org.apache.cassandra.locator.SimpleSeedProvider",
                                 "parameters": [{"seeds": "10.0.219.209"}]}],
          },
          "post_configuration_script": "#! /bin/bash\nyum install cloud-init-cfn",
          "start_scylla_on_first_boot": true
     }
     

     For full documentation of ScyllaDB AMI user data, see the ScyllaDB Image documentation.

4. Add storage.

   • ScyllaDB AMI requires XFS to work. You must attach at least one drive for ScyllaDB to use as XFS for the data directory. When attaching more than one drive, the AMI setup will install RAID0 on all of them.

   • The ScyllaDB AMI requires at least two instance store volumes. The ScyllaDB data directory will be formatted with XFS when the instance first boots. ScyllaDB will fail to start if only one volume is configured.

5. Tag your instance.

6. Click Launch Cluster. You now have a running ScyllaDB cluster on EC2.

7. Connect to the servers using the username scyllaadm.

   ssh -i your-key-pair.pem scyllaadm@ec2-public-ip
   

   The default file paths:

   • The scylla.yaml file: /etc/scylla/scylla.yaml

   • Data: /var/lib/scylla/

   To check that the ScyllaDB server is running, run:

   nodetool status
   

Next Steps¶

• Configure ScyllaDB

• Manage your clusters with ScyllaDB Manager

• Monitor your cluster and data with ScyllaDB Monitoring

• Get familiar with ScyllaDB’s command line reference guide.

• Learn about ScyllaDB at ScyllaDB University