Using environment variables

Configure the DataStax Enterprise (DSE) Docker image by setting environment variables when the container is created. Use the docker run command -e option, or set in the docker compose script.

Variable Type Description Default

DS_LICENSE

string a

To show and acknowledge the license, set DS_LICENSE to accept.

[IMPORTANT] ==== Setting the DS_LICENSE environment variable signals your acceptance of the DataStax terms of service and is required for the software to start. ====

unset

LISTEN_ADDRESS

IP_address

IP address to listen for connections from other nodes.

The container IP address

BROADCAST_ADDRESS

IP_address

IP address to advertise to other nodes.

If not set, the default value is the LISTEN_ADDRESS.

NATIVE_TRANSPORT_ADDRESS

IP_address

IP address to list for client and driver connections.

0.0.0.0

NATIVE_TRANSPORT_BROADCAST_ADDRESS

IP_address

IP address to advertise to clients and drivers.

If not set, the default value is the BROADCAST_ADDRESS.

SEEDS

IP_address

Comma-delimited list of seed nodes for the cluster.

If not set, the default value is the node’s BROADCAST_ADDRESS.

START_NATIVE_TRANSPORT

Boolean

Whether to start the Thrift RPC server.

If not set, the default value is preserved in cassandra.yaml.

CLUSTER_NAME

string

Name of the cluster.

Test Cluster

NUM_TOKENS

int

Number of tokens randomly assigned to the node.

8

DC

string

Datacenter name

Cassandra

RACK

string

Rack name

rack1

OPSCENTER_IP

IP_address

Address of the OpsCenter instance to use for DSE management.

The value can be specified by linking the OpsCenter container using opscenter as the name.

JVM_EXTRA_OPTS

string

Sets a custom value for the JVM heap using -Xmx and -Xms.

LANG

string

Sets a custom locale.

SNITCH

string

Sets the snitch implementation this node will use.

The value is set in the endpoint_snitch parameter in cassandra.yaml.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2025 DataStax, an IBM Company | Privacy policy | Terms of use | Manage Privacy Choices

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, info@datastax.com