Back to Scylladb

Install ScyllaDB Without root Privileges

docs/getting-started/installation-common/unified-installer.rst

latest3.9 KB
Original Source

==================================================== Install ScyllaDB Without root Privileges

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).

Prerequisites

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 and Install

#. 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:

#. 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

Configure and Run ScyllaDB

#. 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``

Upgrade/ Downgrade/ Uninstall

.. _unified-installed-upgrade:

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.

Uninstall

Root uninstall:

.. code:: sh

sudo ./uninstall.sh

Nonroot uninstall

.. code:: sh

./uninstall.sh --nonroot

Downgrade

To downgrade to your original ScyllaDB version, use the Uninstall_ procedure, then install the original ScyllaDB version.

Next Steps

  • :doc:Configure ScyllaDB </getting-started/system-configuration>
  • Manage your clusters with ScyllaDB Manager <https://manager.docs.scylladb.com/>_
  • Monitor your cluster and data with ScyllaDB Monitoring <https://monitoring.docs.scylladb.com/>_
  • Get familiar with ScyllaDB’s :doc:command line reference guide </operating-scylla/nodetool>.
  • Learn about ScyllaDB at ScyllaDB University <https://university.scylladb.com/>_