Difficulty: Intermediate
Estimated Time: 10-15 minutes

One of the easiest ways to get started with Apache Cassandra™ is using Astra DB

In this scenario, we'll learn how to:

  • Create an Astra DB database
  • Create a container for cqlsh that connects to Astra DB
  • Create a table in Astra DB
  • Insert and query data

Astra DB is a great Cassandra as a Service offering and Docker containers are really slick, so this is going to be fun! Let's get started!

This scenario is also available on our datastax.com/dev site, where you can find many more resources to help you succeed with Apache Cassandra™.

ver 0.002

Congratulations! you know how to get a quick start Docker for cqlsh and connect to Apache Cassandra™ via Astra DB.

Check out the offical Cassandra Docker images on Docker Hub.

Interested in learning how to connect to Astra DB with a REST API? Try the Astra DB REST API Service scenario on datastax.com/dev.

Was this helpful? Please give this scenario a rating (click on the stars above).

Have questions or more feedback? Send us a message.

Continue experimenting with your free 5 GB Cassandra database in the cloud at astra.datastax.com!

Connect to Astra DB (Cassandra as a Service) with CQL Shell using Docker

Step 1 of 5

Create your Astra DB Database

If you don't have an Astra account, set one up - it's easy.

Go to the Astra DB page in your browser astra.datastax.com.

Let's create the database. Follow the steps outlined here. To make life easy, we have recommended the values you should use for this scenario.


NOTE: If you already have an Astra DB database with values that differ from what we suggested, you may have to adapt some of the operations in this scenario accordingly, or create an additional keyspace with the designated values.


If you don't already have an Astra DB database, when you log in the first time you'll see a screen that looks like the image below.

Astra DB Add Database

Configure your database by selecting the Free plan.

Select free plan

Next, select a provider and region. Then, click Configure.

Select provider and region

Fill in the Configure and Create Database fields with the following values. Then, click the Create Database button.

  • Database name: FirstDB
  • Keyspace name: user_management
  • Database username: DBUser
  • Database password: DBPassword1

Configure and Create Database

You will see the list of databases with your newly created database. While the database is initializing, the CONNECT button is inactive, but becomes active once the database is ready.

Connect Database dashboard

It may take a minute for the database to deploy, but you'll get an email when it's ready.

Congratulations! You have an active Cassandra database!