sourcemation/cassandra repository overview

⁠Apache Cassandra packaged by Sourcemation

This Cassandra distribution is provided by the upstream Apache packaging team.

⁠Usage

⁠Scenario 1: Running a Single Node (for Development/Testing)

This command starts a single Cassandra node, which is useful for application development and testing.

docker run -d --name cassandra-node1 \
  -p 9042:9042 \
  --restart always \
  -e CASSANDRA_CLUSTER_NAME="TestCluster" \
  -e JVM_EXTRA_OPTS="-Xms1g -Xmx1g" \
  sourcemation/cassandra

After a minute, you can check its status by running docker exec cassandra-node1 nodetool status.

⁠Advanced usage examples

This image is designed to easily form a cluster. To allow the nodes to communicate with each other, they must be on the same Docker network.

Step 1: Create a Docker Network (you only need to do this once)

This command creates a dedicated network for your cluster.

docker network create my-cassandra-net

Step 2: Start the first node (the "seed" node)

The first node will act as the contact point for other nodes joining the cluster. It must be connected to the network you just created.

docker run -d --name cassandra-seed-1 \
  --network my-cassandra-net \
  -e CASSANDRA_CLUSTER_NAME="MyCassandraCluster" \
  -e JVM_EXTRA_OPTS="-Xms1g -Xmx1g" \
  sourcemation/cassandra

Step 3: Start the second node and connect it to the seed

Wait about 60 seconds for the seed node to initialize. Then, start the second node, connecting it to the same network and pointing it to the first node using its container name (cassandra-seed-1) as the seed address.

docker run -d --name cassandra-node-2 \
  --network my-cassandra-net \
  -e CASSANDRA_CLUSTER_NAME="MyCassandraCluster" \
  -e CASSANDRA_SEEDS="cassandra-seed-1" \
  -e JVM_EXTRA_OPTS="-Xms1g -Xmx1g" \
  sourcemation/cassandra

Step 4: Verify the cluster status

After another minute, you can check the status from the seed node. You should see two nodes listed with a "UN" (Up/Normal) status.

docker exec -it cassandra-seed-1 nodetool status

⁠Image tags and versions

The sourcemation/cassandra image itself comes in debian-13 flavor. The tag latest refers to the Debian-based flavor.

⁠Environment Vars, Ports, Volumes

This container is configured at runtime using the following environment variables:

This image exposes the following ports:

• 9042 - The primary port for clients to connect using the CQL native protocol.
• 7000 - Port used for inter-node communication within the cluster.

Please note that the ports need to be either manually forwarded with the -p option or let Docker choose some for you with the -P option.

⁠Contributing and Issues

We'd love for you to contribute! You can request new features, report bugs, or submit a pull request with your contribution to this image on the Sourcemation GitHub repository.

• Creating issues, feature requests, and bug reports⁠
• Creating pull requests⁠

Disclaimer: The sourcemation/cassandra image is not affiliated with the Apache Software Foundation. The respective companies and organisations own the trademarks mentioned in the offering. The sourcemation/cassandra image is a separate project and is maintained by Sourcemation⁠.

⁠Extra notes

⁠Image and its components Risk Analysis report

A detailed risk analysis report of the image and its components can be found on the Sourcemation platform⁠.

For more information, check out the Apache Cassandra website⁠.

⁠Licenses

The base license for the solution (Apache Cassandra) is the Apache License 2.0⁠. The licenses for each component shipped as part of this image can be found on the image's appropriate Sourcemation entry⁠.