Install Hyper-Converged Database 1.0 (HCD 1.0) using a docker image

In general, this method of installation is used if you prefer to run HCD in a containerized environment. The following steps set up HCD in a Docker container that is running on your local machine. The installation can be run within the container as any user on Linux or Mac. You may either run HCD only using a docker run command, or run HCD with the Data API using a docker-compose command.


  • Docker must be installed and configured on your machine.

    • The Docker container will have the appropriate Java runtime environment (Java 11) and Python 3 installed in the execution environment.

HCD only

The following command will start HCD on a standalone container:

docker run -e DS_LICENSE=accept -p 9042:9042 \

The -p option of the docker run command ensures that the cqlsh port is exported and available from outside the container. The database is up and running when the following message is visible in the output:

INFO  [main] 2023-07-20 07:53:28,954 - 
Starting listening for CQL clients on / (unencrypted)...

You can now establish a connection to HCD using the Cassandra Query Language (CQL) shell cqlsh.

HCD with Data API

A docker-compose file is available to run HCD with the Data API. See the Data API github repository for more information.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 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,