Getting Started with Scylla on Ubuntu


  • Ubuntu 14.04 with kernel 3.15 or later for the 64-bit x86_64 architecture. Check and update Ubuntu kernel.
  • Root or sudo access to the system. The Scylla packages create a scylla user. When starting Scylla as a service, the service runs as this user.

For server configuration, see documentation on recommendations for high performance.


sudo add-apt-repository -y ppa:openjdk-r/ppa
sudo apt-get update
sudo apt-get install -y openjdk-8-jre-headless
sudo update-java-alternatives -s java-1.8.0-openjdk-amd64
  • install packages
sudo apt-get update
sudo apt-get install scylla

(if prompt for Postfix Configuration, choose No configuration)

Configure and run Scylla on Ubuntu 14.04

Configure Scylla

Configure the /etc/scylla/scylla.yaml file with the following parameters:

Item Content
cluster_name Name of the cluster, all the nodes in the cluster must have the same name
seeds Seed nodes are used during startup to bootstrap the gossip process and join the cluster
listen_address IP address that the Scylla use to connect to other Scylla nodes in the cluster
rpc_address IP address of interface for client connections (Thrift, CQL)

More information regard the scylla.yaml file

Scylla setup

Run the scylla_setup script to tune the system settings

sudo scylla_setup

This script invokes a set of scripts to configure several operating system settings, like setting RAID0 and XFS filesystem. It also runs a short (up to a few minutes) benchmark on your storage and generates the /etc/scylla.d/io.conf configuration file. When the file is ready, you can start Scylla (see below). Scylla will not run without XFS or io.conf file. To bypass this check, set Scylla to developer mode

Run Scylla as a service

sudo service scylla-server start

If Scylla starts successfully, you will see:

$ sudo service scylla-server start
scylla-server start/running, process 9367

Run nodetool

nodetool status

Run cqlsh


Run cassandra-stress

Finally, to test the Scylla node, run cassandra-stress:

cassandra-stress write -mode cql3 native


Scylla servers set up using this method have the system configuration covered on System Configuration Guide already applied, by the deb package install scripts. See the guide for a complete reference on settings used.

Getting Started