Docker-Cassandra
Scripts and configuration files to run Apache Cassandra clusters using Docker containers with automated networking.
What is Docker-Cassandra?
Docker Cassandra is a set of scripts and configuration files that automate the deployment of Apache Cassandra clusters using Docker containers. It solves the complexity of manually setting up networked Cassandra nodes by providing tools to create, connect to, and manage containerized clusters with proper IP assignment and hostname configuration.
Developers and DevOps engineers who need to run Cassandra clusters for development, testing, or small-scale production environments using containerization.
It offers a lightweight, script-driven alternative to complex orchestration systems, making it easy to spin up isolated Cassandra clusters with minimal configuration while maintaining network transparency and client accessibility.
Overview
A set of scripts and config files to run a Cassandra cluster from Docker
Use Cases
Best For
- Local development environments needing isolated Cassandra instances
- Testing distributed database applications with multi-node setups
- Learning Cassandra clustering and networking concepts
- Quick prototyping with containerized NoSQL databases
- Small-scale deployments where full orchestration is unnecessary
- Scenarios requiring direct control over container networking
Not Ideal For
- Production environments requiring automated scaling, high availability, and integration with modern orchestration tools like Kubernetes
- Projects needing the latest Cassandra features or versions beyond 2.0.x due to limited version support
- Teams using infrastructure-as-code tools like Docker Compose or Ansible, as this relies on custom shell scripts and manual pipework setup
- Environments with restricted sudo access or security policies that prevent privileged container operations
Pros & Cons
Pros
The start-cluster.sh script lets you launch multi-node Cassandra clusters with a single command, automating IP assignment and hostname configuration as shown in the example session.
Includes client.sh to run Cassandra tools like nodetool and cqlsh from containers with network access, making it easy to interact with the cluster without manual configuration.
Provides stop-cluster.sh to terminate and remove all cluster containers cleanly, helping avoid resource leaks and simplifying cleanup.
Uses pipework to create a dedicated network (192.168.100.0/24) for Cassandra nodes, ensuring isolated and predictable networking for testing.
Cons
Only supports Cassandra 1.2 and 2.0, missing newer versions with critical updates, which limits its usefulness for modern applications.
All scripts assume sudo privileges, which can be a barrier in secured or automated environments and introduces potential security risks.
Relies on pipework for networking, an external tool that requires manual installation and may have compatibility issues with newer Docker versions.
The README lacks detailed troubleshooting guides and the project appears unmaintained for newer Cassandra releases, increasing setup friction.
Frequently Asked Questions
Related Projects
Example code from the Docker Meet Cassandra ArticleThe repo for the following Meetup: https://www.meetup.com/Austin-Cassandra-Users/events/243752170.
Packer: Cassandra ImageCassandra Image using Packer for Docker and EC2 AMI. Covers managing EC2 Cassandra clusters with Ansible.
Cassandra DockerInstaclustr dockerfiles for Apache Cassandra
Cassandra & Zeppelin Notebook on DockerDocker-Compose script for Cassandra + Zeppelin setup
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.