Caution

You're viewing documentation for a previous version of ScyllaDB Open Source. Switch to the latest stable version.

ScyllaDB Docs ScyllaDB Open Source Getting Started Install ScyllaDB Install ScyllaDB Linux Packages

Install ScyllaDB Linux Packages¶

We recommend installing ScyllaDB using ScyllaDB Web Installer for Linux, a platform-agnostic installation script, to install ScyllaDB on any supported Linux platform. Alternatively, you can install ScyllaDB using Linux packages.

This article will help you install ScyllaDB on Linux using platform-specific packages.

Prerequisites¶

Ubuntu, Debian, CentOS, or RHEL (see OS Support by Platform and Version for details about supported versions and architecture)
Root or sudo access to the system
Open ports used by ScyllaDB
(CentOS and RHEL only) Removing Automatic Bug Reporting Tool (ABRT) if installed before installing ScyllaDB, as it may conflict with ScyllaDB coredump configuration:
```
sudo yum remove -y abrt
```

Install ScyllaDB¶

Install a repo file and add the ScyllaDB APT repository to your system.

sudo mkdir -p /etc/apt/keyrings

sudo gpg --homedir /tmp --no-default-keyring --keyring /etc/apt/keyrings/scylladb.gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys d0a112e067426ab2

sudo wget -O /etc/apt/sources.list.d/scylla.list http://downloads.scylladb.com/deb/debian/scylla-5.4.list

Install ScyllaDB packages.

sudo apt-get update
sudo apt-get install -y scylla

Running the command installs the latest official version of ScyllaDB Open Source. To install a specific patch version, list all the available patch versions:

apt-cache madison scylla

Then install the selected patch version:

apt-get install scylla{,-server,-jmx,-tools,-tools-core,-kernel-conf,-node-exporter,-conf,-python3}=<your patch version>

The following example shows installing ScyllaDB 5.2.3.

apt-cache madison scylla
scylla | 5.2.3-0.20230608.ea08d409f155-1 | https://downloads.scylladb.com/downloads/scylla/deb/debian-ubuntu/scylladb-5.2 stable/main amd64 Packages
scylla | 5.2.2-0.20230521.9dd70a58c3f9-1 | https://downloads.scylladb.com/downloads/scylla/deb/debian-ubuntu/scylladb-5.2 stable/main amd64 Packages
scylla | 5.2.1-0.20230508.f1c45553bc29-1 | https://downloads.scylladb.com/downloads/scylla/deb/debian-ubuntu/scylladb-5.2 stable/main amd64 Packages
scylla | 5.2.0-0.20230427.429b696bbc1b-1 | https://downloads.scylladb.com/downloads/scylla/deb/debian-ubuntu/scylladb-5.2 stable/main amd64 Packages

apt-get install scylla{,-server,-jmx,-tools,-tools-core,-kernel-conf,-node-exporter,-conf,-python3}=5.2.3-0.20230608.ea08d409f155-1

(Ubuntu only) Set Java 11.

sudo apt-get update
sudo apt-get install -y openjdk-11-jre-headless
sudo update-java-alternatives --jre-headless -s java-1.11.0-openjdk-amd64

Install the EPEL repository.

CentOS:

sudo yum install epel-release

Rocky/RHEL 8

sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

Rocky/RHEL 9

sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

Add the ScyllaDB RPM repository to your system.

sudo curl -o /etc/yum.repos.d/scylla.repo -L http://downloads.scylladb.com/rpm/centos/scylla-5.4.repo

Install ScyllaDB packages.
sudo yum install scylla
Running the command installs the latest official version of ScyllaDB Open Source. Alternatively, you can to install a specific patch version:
sudo yum install scylla-<your patch version>
Example: The following example shows the command to install ScyllaDB 5.2.3.
sudo yum install scylla-5.2.3

Configure and Run ScyllaDB¶

Configure the following parameters in the /etc/scylla/scylla.yaml configuration file.
- cluster_name - The name of the cluster. All the nodes in the cluster must have the same cluster name configured.
- seeds - The IP address of the first node. Other nodes will use it as the first contact point to discover the cluster topology when joining the cluster.
- listen_address - The IP address that ScyllaDB uses to connect to other nodes in the cluster.
- rpc_address - The IP address of the interface for client connections (Thrift, CQL).
Run the scylla_setup script to tune the system settings and determine the optimal configuration.
```
sudo scylla_setup
```
- The script invokes a set of scripts to configure several operating system settings; for example, it sets RAID0 and XFS filesystem.
- The script 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 ScyllaDB. ScyllaDB will not run without XFS or io.conf file.
- You can bypass this check by running ScyllaDB in developer mode. We recommend against enabling developer mode in production environments to ensure ScyllaDB’s maximum performance.
Run ScyllaDB as a service (if not already running).
```
sudo systemctl start scylla-server
```

Now you can start using ScyllaDB. Here are some tools you may find useful.

Run nodetool:

nodetool status

Run cqlsh:

cqlsh

Run cassandra-stress:

cassandra-stress write -mode cql3 native

Next Steps¶

Configure ScyllaDB
Manage your clusters with ScyllaDB Manager
Monitor your cluster and data with ScyllaDB Monitoring
Get familiar with ScyllaDB’s command line reference guide.
Learn about ScyllaDB at ScyllaDB University

Was this page helpful?