Apache Cassandra™ 1.2

Using cqlsh with SSL encryption

Using a .cqlshrc file, or cqlshrc file in Cassandra 1.2.9 and later, means you don't have to override the SSL_CERTFILE environmental variables every time.

To run cqlsh, you must create a .cqlshrc or cqlshrc file in your home or client program directory. In Cassandra 1.2.9 and later, create the cqlshrc file in your ~/.cassandra directory. You cannot use cqlsh when client certificate authentication is enabled (require_client_auth=true). Sample files are available in the following directories:

  • Packaged installs: /etc/cassandra
  • Binary installs: <install_location>/conf


username = fred
password = !!bang!!$

hostname =
port = 9160
factory = cqlshlib.ssl.ssl_transport_factory

certfile = ~/keys/cassandra.cert
validate = true ## Optional, true by default.

[certfiles] ## Optional section, overrides the default certfile in the [ssl] section. = ~/keys/cassandra01.cert = ~/keys/cassandra02.cert

When validate is enabled, the host in the certificate is compared to the host of the machine that it is connected to. The SSL certificate must be provided either in the configuration file or as an environment variable. The environment variables (SSL_CERTFILE and SSL_VALIDATE) override any options set in this file.

Related topics

The cassandra.yaml configuration file