Difficulty: Beginner
Estimated Time: 6 minutes

In this lab, you will see how to quickly start Scylla by running a single instance using Docker. You will then see how to run the CQL Shell and perform some basic CQL operations such as creating a table, inserting data and reading it.

This lab is part of Scylla University.

Congratulations! You have completed the Quick Wins: Install and Run Scylla Lab. Continue to the next lesson, you'll have a chance to do more labs later on in the course.

ScyllaDB: Quick Wins: Install and Start Scylla Lab

Step 1 of 2

Install and Start Scylla

In production, a Scylla cluster should have at least three nodes in a cluster. In this lab, just for the demonstration you will start by creating a single node cluster.

Create a Scylla Cluster

Start a single instance and call it ScyllaU:

docker run --name scyllaU -d scylladb/scylla:4.3.0 --overprovisioned 1 --smp 1

Notice that when running Scylla on Docker and in scenarios in which static partitioning is not desired - like mostly-idle cluster without hard latency requirements, the --overprovisioned command-line option is recommended. This enables certain optimizations for Scylla to run efficiently in an overprovisioned environment.

The --smp command line option restricts Scylla to COUNT number of CPUs.

Some files will be downloaded in this step. After the download wait for a few seconds, and verify that the cluster is up and running with the Nodetool Status command:

docker exec -it scyllaU nodetool status

The node scyllaU has a UN status. “U” means up, and N means normal. Read more about Nodetool Status here. If you run the command and the node is not up and running yet wait a few more seconds and run it again.

Finally, we use the CQL Shell to interact with Scylla:

docker exec -it scyllaU cqlsh

Notice that if you run cqlsh before the cluster is ready you'll get a connection error. In that case wait for a few more seconds until the cluster is up and try again.

The CQL Shell allows us to run Cassandra Query Language commands on Scylla, as we will see in the next part.

You can read more about getting started with Scylla in the documentation.