Operators Developers Contributors Reference
Sidebar updates per section — preview limitation
Apache Cassandra

Operator Quickstart

Preview | Unofficial | For review only

Use this page to get a single Cassandra node running quickly, then confirm that you can connect and clean up afterward.

Local Evaluation with Docker

  1. Pull the image:

docker pull cassandra:latest

  1. Start Cassandra:

docker run --name cassandra -d -p 9042:9042 cassandra:latest

  1. Wait about 30 seconds for startup, then connect:

docker exec -it cassandra cqlsh

  1. Check the node state:

docker exec -it cassandra nodetool status

You should see one node listed with status UN:

Datacenter: datacenter1
=======================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address     Load      Tokens  Owns (effective)  Host ID                               Rack
UN  172.17.0.2  123.45 KiB  1      100.0%            01234567-89ab-cdef-0123-456789abcdef  rack1

To clean up the evaluation container, stop and remove it:

docker rm -f cassandra

Production Pilot

Use a production pilot when you want to validate a single host before you build out a cluster.

  1. Follow the Installation Guide.

  2. Set listen_address and rpc_address in cassandra.yaml.

  3. Start Cassandra with your service manager.

  4. Verify the node reaches UN before you continue.

Production Cluster

Use this path when you are building the real cluster.

  1. Plan rack and datacenter placement before you install anything.

  2. Follow the Installation Guide on every node.

  3. Configure cluster_name, seeds, and node addresses consistently.

  4. Start one node at a time and wait for each node to reach UN.

Next Steps