Install Cassandra DB on Windows 11 [Guide]

ByLiam Last Updated On

If you want to work with a powerful NoSQL database on your Windows 11 PC, Apache Cassandra is one of the best options available. 

Installing Cassandra on Windows 11 may look complicated at first because it depends on additional tools like the Java Development Kit (JDK) and Apache Cassandra binaries. However, once you follow the correct sequence, the installation process becomes surprisingly straightforward.

In this guide, you will learn how to install Cassandra DB on Windows 11 step by step. 

What is Apache Cassandra?

Apache Cassandra is an open source NoSQL database designed for handling huge amounts of structured data across multiple servers. It was originally developed by Facebook and later became an Apache Software Foundation project.

The biggest advantage of Cassandra is its distributed architecture. Instead of storing all data on one machine, Cassandra spreads data across different systems while keeping everything synchronized. This allows applications to remain online even if one server fails.

Some common features of Cassandra include:

  • High Availability: Cassandra continues working even during hardware failures.
  • Scalability: You can add more servers without affecting performance.
  • Fast Write Operations: It is optimized for handling heavy write workloads.
  • Fault Tolerance: Data replication ensures reliability across nodes.
  • Flexible Data Model: Cassandra works well for unstructured and semi-structured data.

System Requirements for Installing Cassandra DB on Windows 11

Before installing Apache Cassandra DB on Windows 11, make sure your computer meets the minimum system requirements. Having the correct software and hardware setup helps Cassandra run smoothly without startup errors or performance issues.

Minimum Hardware Requirements

For basic learning, testing, and development purposes, your Windows 11 PC should have:

Processor: Intel Core i3 or higher

RAM: Minimum 4 GB RAM, Recommended 8 GB or more for better performance

Storage Space: At least 5 GB of free disk space

Internet Connection: Required for downloading Java, Python, and Cassandra packages

Supported Operating System

Cassandra can run on: Windows 11 64-bit

Although Cassandra is officially optimized for Linux environments, it still works properly on Windows 11 for development and educational use.

Required Software Components

Before installing Cassandra, you must install the following dependencies:

Java Development Kit (JDK)

Apache Cassandra requires Java to run.

Supported versions usually include: JDK 11, JDK 17, JDK 21

You can download Java from: Oracle Java Downloads or OpenJDK

Python

Some Cassandra tools, especially CQLSH, require Python.

Recommended version: Python 3.x

Download it from: Python Official Website

Recommended Environment Variables

To run Cassandra properly, the following environment variables should be configured in Windows 11: JAVA_HOME

Example path: C:\Program Files\Java\jdk-21

CASSANDRA_HOME

Example path: C:\Cassandra\apache-cassandra-5.0

Both variables should also be added to the Windows Path variable.

Recommended Network Ports

Apache Cassandra commonly uses these ports:

  • 9042 for CQL client connections
  • 7000 for node communication
  • 7199 for JMX monitoring

Make sure these ports are not blocked by Windows Firewall or another application.

Recommended Installation Folder

For easier setup and management, install Cassandra in a simple directory such as C:\Cassandra

Avoid installing Cassandra inside deeply nested folders because it may create path-related issues later.

Install Cassandra DB on Windows 11 

Install Cassandra DB on Windows 11 [Guide]
Install Cassandra DB on Windows 11 [Guide]

To install Apache Cassandra DB on Windows 11, first install Java JDK, then download and extract the Cassandra package. After that, configure the JAVA_HOME and CASSANDRA_HOME environment variables, add the required paths to the Windows system variables, and start Cassandra using the Command Prompt. Finally, verify the installation by launching the Cassandra shell using the cqlsh command.

Step 1: Install Java Development Kit (JDK)

Before installing Cassandra, you must install Java because Cassandra runs on the Java platform. Without Java, Cassandra will not start properly.

Apache Cassandra works best with supported versions of OpenJDK or Oracle JDK.

First, open your browser and visit the official Java download page from Oracle Java Downloads or OpenJDK. Download the latest supported JDK installer for Windows x64.

After the file downloads, open the installer and follow the setup wizard.

Select the installation location carefully. Most Windows systems install Java in a path similar to: C:\Program Files\Java\jdk-21

Once the installation finishes, you should verify that Java works correctly. Go to: Start Menu > Search > Command Prompt

Open Command Prompt and type: java -version

If Java is installed correctly, Windows will display the installed Java version. Next, check the Java compiler by entering: javac -version

You should now see the installed compiler version.

This confirms that Java is successfully installed on your Windows 11 computer.

Step 2: Download Apache Cassandra for Windows 11

Now that Java is ready, the next step is downloading Apache Cassandra.

Open your browser and visit the official Cassandra website:

Apache Cassandra Official Website

Download the latest stable binary package in ZIP format.

After the download completes, locate the ZIP file inside your Downloads folder.

  • Go to: File Explorer > Downloads
  • Right-click the Cassandra ZIP file and select Extract All.
  • Choose a simple extraction path for easier management. For example: C:\Cassandra
  • After extraction, your folder structure may look like this:
    • C:\Cassandra\apache-cassandra-5.0
  • Inside this folder, you will see several important directories such as: bin, conf, data, logs
  • The bin folder contains executable scripts used to start Cassandra and access the Cassandra Shell.
    • The conf folder stores configuration files.
    • The data folder stores database files.
    • The logs folder keeps runtime logs for troubleshooting.

At this point, Cassandra files are available on your Windows 11 PC, but the database still needs proper environment configuration.

Step 3: Configure JAVA_HOME Environment Variable

Even though Java is installed, Cassandra may not detect it automatically unless the JAVA_HOME environment variable is configured.

To set JAVA_HOME in Windows 11, go to:

Start Menu > Search > View Advanced System Settings

Under the Advanced tab, click Environment Variables.

Inside the System Variables section, click New.

For the variable name, type:

JAVA_HOME

For the variable value, enter your Java installation path. Example:

C:\Program Files\Java\jdk-21

Click OK to save the variable.

Next, locate the Path variable inside System Variables and click Edit.

Click New and add:

%JAVA_HOME%\bin

Click OK on all open windows to apply the changes.

Now restart Command Prompt and verify the configuration by entering:

echo %JAVA_HOME%

Windows should display your Java installation directory.

This step is important because Cassandra relies on the JAVA_HOME variable to locate Java runtime files.

Step 4: Configure CASSANDRA_HOME Variable

After setting up Java, you should configure the Cassandra environment variable.

Go to:

Start Menu > Search > View Advanced System Settings > Environment Variables

Under System Variables, click New.

For the variable name, type:

CASSANDRA_HOME

For the variable value, enter the extracted Cassandra folder path. Example:

C:\Cassandra\apache-cassandra-5.0

Click OK.

Now edit the existing Path variable again.

Click New and add:

%CASSANDRA_HOME%\bin

Save the changes by clicking OK.

This configuration allows Windows to run Cassandra commands globally through Command Prompt without navigating to the installation folder every time.

To verify the configuration, open a new Command Prompt window and enter:

echo %CASSANDRA_HOME%

The terminal should display your Cassandra installation path.

Step 5: Install Python for Cassandra Shell

Many Cassandra versions require Python to run the CQLSH utility.

CQLSH stands for Cassandra Query Language Shell, which allows you to interact with the database.

Open your browser and visit:

Python Official Website

Download the latest Python installer for Windows.

Run the installer and make sure to enable the checkbox:

Add Python to PATH

This option is extremely important.

After installation, open Command Prompt and verify Python by typing:

python –version

Windows should display the installed Python version.

If you skip this step, the Cassandra shell may fail to launch correctly.

Step 6: Start Apache Cassandra on Windows 11

Now you are ready to start Cassandra DB for the first time.

Open Command Prompt as Administrator.

Go to the Cassandra bin directory using:

cd C:\Cassandra\apache-cassandra-5.0\bin

Next, start Cassandra using this command:

cassandra

The database server will now initialize.

During startup, the terminal may display several log entries. This is completely normal.

Wait until Cassandra finishes loading.

If the installation is successful, the server will continue running without showing major errors.

Do not close this Command Prompt window because Cassandra runs inside it.

If you see firewall permission requests from Windows Security, click Allow Access.

This enables Cassandra networking functions on your local machine.

Step 7: Launch Cassandra Query Language Shell (CQLSH)

After starting Cassandra, you can access the database using CQLSH.

Open another Command Prompt window.

Go to:

cd C:\Cassandra\apache-cassandra-5.0\bin

Now launch the shell using:

cqlsh

If everything is configured correctly, you will see output similar to:

Connected to Test Cluster at 127.0.0.1:9042

[cqlsh 6.0.0 | Cassandra 5.0]

This means Cassandra DB is successfully running on Windows 11.

You can now execute Cassandra queries.

For example, try:

DESCRIBE KEYSPACES;

This command displays available keyspaces inside the database.

To exit the shell, type:

exit

Step 8: Create a Test Keyspace in Cassandra

Testing the database helps confirm that everything works properly.

Inside CQLSH, create a test keyspace using:

CREATE KEYSPACE testdb

WITH replication = {‘class’:’SimpleStrategy’,’replication_factor’:1};

Now switch to the new keyspace:

USE testdb;

Next, create a sample table:

CREATE TABLE users (

id UUID PRIMARY KEY,

name TEXT,

email TEXT

);

You can verify the table using:

DESCRIBE TABLES;

If the table appears successfully, your Cassandra installation is fully functional.

Step 9: Understand Important Cassandra Files and Folders

Once Cassandra is installed, understanding its file structure becomes useful for troubleshooting and configuration.

The main configuration file is located at:

C:\Cassandra\apache-cassandra-5.0\conf\cassandra.yaml

This file controls settings such as:

  • Cluster name
  • Storage paths
  • Ports
  • Memory settings
  • Replication behavior

Log files are usually stored in:

C:\Cassandra\apache-cassandra-5.0\logs

Temporary database files and storage directories are located inside:

C:\Cassandra\apache-cassandra-5.0\data

You should avoid deleting these folders unless you intentionally want to remove database data.

FAQs

Is Apache Cassandra free to use?

Yes, Apache Cassandra is completely free and open source under the Apache License.

Can Cassandra run on Windows 11?

Yes, Cassandra works on Windows 11, although many production environments prefer Linux servers.

Does Cassandra require Java?

Yes, Cassandra depends on Java because the database engine runs on the Java Virtual Machine.

What is CQLSH in Cassandra?

CQLSH is the Cassandra Query Language Shell used to interact with the database through commands and queries.

Can I use Cassandra for small projects?

Yes, beginners can use Cassandra for learning, testing, and small development projects.

Which port does Cassandra use by default?

Cassandra commonly uses port 9042 for client connections.

Is Cassandra better than MySQL?

Cassandra and MySQL serve different purposes. Cassandra is designed for distributed scalability and high availability, while MySQL is a relational database optimized for structured transactions.

Summary

Installing Apache Cassandra DB on Windows 11 involves several important steps, including setting up Java, downloading Cassandra binaries, configuring environment variables, and launching the database server properly. While the setup process may initially seem technical, it becomes much easier when you follow the correct sequence carefully.

After installation, you can use CQLSH to manage databases, create tables, and run queries directly from the command line. Cassandra is an excellent choice for developers who want to explore distributed databases, big data systems, and scalable NoSQL technologies.

Hi, my name is Liam, I'm the man who shares his tech experience on GadgetsNurture by writing articles (About error codes, Guides, or How To's). I have more than 10 years of experience having a good knowledge of technology and Gadgets. I faced many issues with my home appliances and gadgets, and sometimes, the apps or other software that I regularly use. So, I decided to help people like me who daily face issues with their gadgets and tech!

Leave a Reply

Your email address will not be published. Required fields are marked *