docs/getting-started/installation-common/unified-installer.rst
This document covers installing, uninstalling, and upgrading ScyllaDB using Unified Installer.
Unified Installer is recommended when you do not have root privileges to the server.
If you have root privileges, we recommend installing ScyllaDB with
:doc:ScyllaDB Web Installer </getting-started/installation-common/scylla-web-installer/>
or by downloading the OS-specific packages (RPMs and DEBs) and installing them with
the package manager (dnf and apt).
Ensure your platform is supported by the ScyllaDB version you want to install.
See OS Support <https://docs.scylladb.com/stable/versioning/os-support-per-version.html>_
for information about supported Linux distributions and versions.
#. Download the latest tar.gz file for ScyllaDB version (x86 or ARM) from https://downloads.scylladb.com/downloads/scylla/relocatable/scylladb-<version>/.
Example for version 2025.1:
scylla-unified file for the patch version you want to
install. For example, to install 2025.1.9 (x86), download
scylla-unified-2025.1.9-0.20251010.6c539463bbda.x86_64.tar.gz.#. Uncompress the downloaded package.
Example for version 2025.1.9 (x86) (downloaded in the previous step):
.. code::
tar xvfz scylla-unified-2025.1.9-0.20251010.6c539463bbda.x86_64.tar.gz
#. (Root offline installation only) For root offline installation on Debian-like
systems, two additional packages, xfsprogs and mdadm, should be
installed to be used in RAID setup.
#. Install ScyllaDB as a user with non-root privileges:
.. code:: console
./install.sh --nonroot
#. Run the ScyllaDB setup script:
.. code:: console
~/scylladb/sbin/scylla_setup
#. Start ScyllaDB:
.. code:: console
systemctl --user start scylla-server
#. Verify that ScyllaDB is running:
.. code:: console
systemctl --user status scylla-server
Now you can start using ScyllaDB. Here are some tools you may find useful.
Run nodetool:
.. code:: console
~/scylladb/bin/nodetool nodetool status
Run cqlsh:
.. code:: console
~/scylladb/bin/cqlsh
.. note::
You can avoid adding the extended prefix to the commands by exporting the binary directories to PATH:
``export PATH=$PATH:~/scylladb/python3/bin:~/scylladb/share/cassandra/bin/:~/scylladb/bin:~/scylladb/sbin``
.. _unified-installed-upgrade:
The unified package is based on a binary package; it’s not a RPM / DEB packages, so it doesn’t upgrade or downgrade by yum / apt. To upgrade ScyllaDB, run the install.sh script.
Root install:
.. code:: sh
./install.sh --upgrade
Nonroot install
.. code:: sh
./install.sh --upgrade --nonroot
.. note:: The installation script does not upgrade scylla-tools. You will have to upgrade them separately.
Root uninstall:
.. code:: sh
sudo ./uninstall.sh
Nonroot uninstall
.. code:: sh
./uninstall.sh --nonroot
To downgrade to your original ScyllaDB version, use the Uninstall_ procedure, then install the original ScyllaDB version.
Configure ScyllaDB </getting-started/system-configuration>ScyllaDB Manager <https://manager.docs.scylladb.com/>_ScyllaDB Monitoring <https://monitoring.docs.scylladb.com/>_command line reference guide </operating-scylla/nodetool>.ScyllaDB University <https://university.scylladb.com/>_