Connect with the Node.js driver

DataStax recommends the Data API and clients for Serverless (Vector) databases. You can use the Data API to perform CQL operations on your table data in Serverless (Vector) databases.

DataStax recommends drivers only for Serverless (Non-Vector) databases, legacy applications that rely on a driver, or for CQL functions that aren’t supported by the Data API. For more information, see Compare connection methods.

To use the DataStax Node.js driver, you need to install the driver and its dependencies, and then connect the driver to your Astra DB Serverless database. Once connected, you can write scripts that use the driver to run commands against your database.

Prerequisites

  1. Create a database.

  2. Set the following environment variables:

    • ASTRA_DB_ID: The database ID

    • ASTRA_DB_REGION: A region where your database is deployed and where you want to connect to the database, such as us-east-2

    • ASTRA_DB_KEYSPACE: A keyspace in your database, such as default_keyspace

    • ASTRA_DB_APPLICATION_TOKEN: An application token with the Database Administrator role.

      The token.json has the following format:

      {
        "clientId": "CLIENT_ID",
        "secret": "CLIENT_SECRET",
        "token": "APPLICATION_TOKEN"
      }

      For driver authentication, you can use either clientId and secret or the literal string token and the AstraCS token value. If you are on an older driver version that doesn’t support the token option, then you might need to use clientId and secret. For more information, see Token details.

  3. Download your database’s Secure Connect Bundle (SCB).

  4. Install Node.js LTS version with npm.

Install the Node.js driver

  1. Install the DataStax Node.js driver:

    npm install cassandra-driver

    Make sure you use a driver version that is compatible with Astra DB. For more information, see DataStax driver matrix.

Connect the Node.js driver

  1. In the root of your Node.js project, create a connect-database.js file:

    cd nodejsProject
    touch connect-database.js
  2. Copy the following connection code into the connect-database.js file, and then replace PATH_TO_SCB with the absolute path to your database’s Secure Connect Bundle (SCB) (secure-connect-DATABASE_NAME.zip):

    connect-database.js
    const cassandra = require('cassandra-driver');
    
    const cloud = { secureConnectBundle: "**PATH_TO_SCB**" };
    const authProvider = new cassandra.auth.PlainTextAuthProvider('token', process.env['ASTRA_DB_APPLICATION_TOKEN']);
    const client = new cassandra.Client({ cloud, authProvider });
    
    async function run() {
        await client.connect();
    
        // ...
    }

    This code creates a Client instance to connect to your Astra DB database, through which you can run commands against your database.

  3. Save and then run connect-database.js with the Node.js runtime to test the connection:

    node connect-database.js

Run commands with the Node.js driver

After you connect to the database, you can use the driver to perform operations on your database. For example, the following code connects to an Astra DB database, runs a CQL query, and then prints the output to the console:

// Import libraries and connect to the database
const cassandra = require('cassandra-driver');

const cloud = { secureConnectBundle: "**PATH_TO_SCB**" };
const authProvider = new cassandra.auth.PlainTextAuthProvider('token', process.env['ASTRA_DB_APPLICATION_TOKEN']);
const client = new cassandra.Client({ cloud, authProvider });

async function run() {
    await client.connect();

    // Execute a query
    const rs = await client.execute('SELECT * FROM system.local');
    console.log(`Hello from cluster: ${rs.first()['cluster_name']}`);
    await client.shutdown();
}

You can extend or modify this example script to run other commands against your database or connect to other databases. For more examples and information, see Node.js driver quickstart, Node.js driver documentation, and Developing applications with DataStax drivers.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2025 DataStax | Privacy policy | Terms of use

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000, info@datastax.com