Preview Updated: January 13, 2017

DC/OS Apache Cassandra is an automated service that makes it easy to deploy and manage on Mesosphere DC/OS. DC/OS Apache Cassandra eliminates nearly all of the complexity traditionally associated with managing a Cassandra cluster. Apache Cassandra is a distributed database management system designed to handle large amounts of data across many nodes, providing horizonal scalablity and high availability with no single point of failure, with a simple query language (CQL). For more information on Apache Cassandra, see the Apache Cassandra documentation. DC/OS Apache Cassandra gives you direct access to the Cassandra API so that existing applications can interoperate. You can configure and install DC/OS Apache Cassandra in moments. Multiple Cassandra clusters can be installed on DC/OS and managed independently, so you can offer Cassandra as a managed service to your organization.


DC/OS Apache Cassandra offers the following benefits:

  • Easy installation
  • Multiple Cassandra clusters
  • Elastic cluster scaling
  • Replication for high availability
  • Integrated monitoring


DC/OS Apache Cassandra provides the following features:

  • Single command installation for rapid provisioning
  • Persistent storage volumes for enhanced data durability
  • Runtime configuration and software updates for high availability
  • Health checks and metrics for monitoring
  • Backup and restore for disaster recovery
  • Cluster wide automation Cleanup and Repair

Quick Start

Install a Cassandra cluster using DC/OS CLI: Note: Your cluster must have at least 3 private nodes. $ dcos package install cassandra Once the cluster is installed, retrieve connect...

Install and Customize

About installing Cassandra on Enterprise DC/OS In Enterprise DC/OS strict security mode, Cassandra requires a service account. In permissive, a service account is optional. Only so...


Overview We support upgrade/rollback between adjacent versions only. Concretely, to upgrade from version 2 to version 4, you must upgrade from 2 -> 3, then from 3 ->4. Upgrade Inst...


Uninstalling a cluster is straightforward. Replace cassandra with the name of the Cassandra instance to be uninstalled. $ dcos package uninstall --app-id=cassandra Then, use the fr...

Multi-Datacenter Deployments

Requirements All nodes in each datacenter MUST be reachable by the configured network addresses. All DC/OS Apache Cassandra deployments participating in the cluster MUST be configu...


Changing Configuration at Runtime You can customize your cluster in-place when it is up and running. The Cassandra scheduler runs as a Marathon process and can be reconfigured by c...

Connecting Clients

The only supported client for the DC/OS Cassandra Service is the Datastax Java CQL Driver. Note that this means that Thrift RPC-based clients are not supported for use with this se...

Backup and Restore

DC/OS Apache Cassandra supports backup and restore from S3 storage for disaster recovery purposes. Cassandra takes a snapshot of your tables and ships them to a remote location. On...


Manage Nodes Add a Node Increase the NODES value via Marathon as described in the Configuration Update section. This creates an update plan as described in that section. An additio...

API Reference

The DC/OS Apache Cassandra Service provides a REST API that may be accessed from outside the cluster. The parameter referenced below indicates the base URL of the DC/OS cluster on ...


Configuration Update Errors The plan below contains a configuration error that will not allow the installation or configuration update to progress. { "errors": ["The number of seed...

Version Policy

The DC/OS Cassandra Service is engineered and tested to work with a specific release of Apache Cassandra, the base technology. We select stable versions of the base technology in o...


Cluster backup and restore can only be performed sequentially across the entire datacenter. While this makes cluster backup and restore time consuming, it also ensures that taking ...