Skip to content

‣ Create Database

📖 Reference Documentation and resources
  1. 📖 Astra Docs - The Astra database creation procedure
  2. 🎥 Youtube Video - Walk through instance creation

A - Overview

ASTRA DB is the simplest way to run Cassandra with zero operations - just push the button and get your cluster. No credit card required and $25.00 USD credit every month (roughly 20M reads/writes, 80GB storage monthly) which is sufficient to run small production workloads.

B - Prerequisites

  • You should have an Astra account. If you don't have one yet, keep reading and we'll show you how to create it.

C - Procedure

Not a fan of user interfaces ?

The procedure on this page describes how to create a database through the user interface. If you have the CLI installed you can also go with a astra db create my_db. More information on the CLI page

✅ Step 1: Click the Create Account button to login or register.

You can use your Github, Google accounts or register with an email. Make sure to chose a password with a minimum of 8 characters, containing upper and lowercase letters, and at least one number and special character.

If you already have an Astra account, you can skip this step. Locate the "Create Database" button, as shown in the next step, and read on.

✅ Step 2: Complete the creation form

If you are creating a new account, you will be brought to the DB-creation form directly.

Otherwise, get to the databases dashboard (by clicking on Databases in the left-hand navigation bar, expanding it if necessary), and click the [Create Database] button on the right.

Take a moment to fill the form:

  • ℹ️ Fields Description
Field Description
Vector Database vs Serverless Database In june 2023, Cassandra introduced the support of vector search to enable Generative AI use cases. You might consume your credit faster with a vector database.
database name It does not need to be unique, is not used to initialize a connection, and is only a label (keep it between 2 and 50 characters). It is recommended to have a database for each of your applications. The free tier is limited to 5 databases.
keyspace It is a logical grouping of your tables (keep it between 2 and 48 characters). Prefer lower case or snake_case, and avoid spaces.
Cloud Provider Choose whatever you like. Click a cloud provider logo, pick an Area in the list and finally pick a region. We recommend choosing a region that is closest to you to reduce latency. In free tier, there is very little difference.

If all fields are filled properly, clicking the "Create Database" button will start the process. It should take a couple of minutes for your database to become Active.

In the meantime, you will be brought to the "Connect" page of the database, that is being provisioned in the meantime. You can track the progression by looking at the status label at the top, next to the database's name.

✅ Step 3: Obtain a Database Token

While the database is created, you can generate and download a Token to later access it from your applications. The automatically-generated token has a "reasonable" set of permissions (limited to this database), but you can also generate a custom token to better suit your needs.

To generate the token click on the "Generate Token" button. The new token can (and should!) be copied elsewhere with the clipboard-icon button and/or downloaded in JSON format for safe storage - it will not be shown anymore once you leave the dialog.

✅ Step 4: Ready

In a couple of minutes, the database will switch to Active. You can now interact with it, for example by downloading a Secure Connect Bundle) and start running applications that access it.

Last update: 2023-07-31