Scylla University Live | July 28 & 29 Free Virtual Training Event
Learn More >

Scylla Configuration Reference

This guide describes the commands that you can use to configure your Scylla clusters. The commands are all sent via the command line in a terminal and sudo or root access is not required as long as you have permission to execute in the directory.

Caution

You should only use configuration settings which are officially supported.

A list of all Scylla commands can be obtained by running

scylla --help

Note

This command displays all Scylla commands as well as Seastar commands. The Seastar commands are listed as Core Options.

For example:

Scylla version 4.2.3-0.20210104.24346215c2 with build-id 0c8faf8bb8a3a0eda9337aad98ed3a6d814a4fa9 starting ...
command used: "scylla --help"
parsed command line options: [help]
Scylla options:
  -h [ --help ]                         show help message
  --version                             print version number and exit
  --options-file arg                    configuration file (i.e.
                                        <SCYLLA_HOME>/conf/scylla.yaml)
  --memtable-flush-static-shares arg    If set to higher than 0, ignore the
                                        controller's output and set the
                                        memtable shares statically. Do not set
                                        this unless you know what you are doing
                                        and suspect a problem in the
                                        controller. This option will be retired
                                        when the controller reaches more
                                        maturity
  --compaction-static-shares arg        If set to higher than 0, ignore the
                                        controller's output and set the
                                        compaction shares statically. Do not
                                        set this unless you know what you are
                                        doing and suspect a problem in the
                                        controller. This option will be retired
                                        when the controller reaches more
                                        maturity

Note

This is an incomplete screenshot. For the complete file, run the command in a terminal.

Scylla Configuration Files and Scylla Commands

Some Scylla Command Line commands are derived from the scylla.yaml configuration parameters.

For example, in the case of cluster_name: 'Test Cluster' as seen in the scylla.yaml configuration parameters.

To send this configuration setting with the command line, run:

scylla --cluster-name 'Test Cluster'

As you can see from the example above, the general rule of thumb is:

  1. Take a configuration parameter from the scylla.yaml file.

  2. Prepend it with scylla --.

  3. In any place where there is an underscore, replace with a dash.

  4. Run the command in a terminal.