ScyllaDB University Live | Free Virtual Training Event
Learn more
ScyllaDB Documentation Logo Documentation
  • Server
  • Cloud
  • Tools
    • ScyllaDB Manager
    • ScyllaDB Monitoring Stack
    • ScyllaDB Operator
  • Drivers
    • CQL Drivers
    • DynamoDB Drivers
  • Resources
    • ScyllaDB University
    • Community Forum
    • Tutorials
Download
ScyllaDB Docs Scylla Manager Install ScyllaDB Manager

Caution

You're viewing documentation for a previous version of Scylla Manager. Switch to the latest stable version.

Install ScyllaDB Manager¶

  • System requirements

  • Install package

  • Configure storage

    • Local node

    • Remote cluster

  • Run the scyllamgr_setup script

  • Enable bash script completion

  • Start ScyllaDB Manager service

  • Next steps

Note

If you need to upgrade Scylla Manager from a previous version please see the Upgrade guide.

System requirements¶

While a minimal server can run on a system with 2 cores and 1GB RAM, the following configuration is recommended:

  • CPU - 2vCPUs

  • Memory - 8GB+ DRAM

Note

If you are running Scylla Monitoring Stack on the same server as Scylla Manager, your system should also meet the minimal Monitoring requirements.

Install package¶

Best practice is to install Scylla Manager Server on a dedicated machine not a Scylla production node. Download and install the Scylla Manager Server and Client packages from the Scylla Download Center.

Configure storage¶

Scylla Manager uses Scylla to store its data. You can either use a local one-node Scylla cluster (recommended) or connect Scylla Manager to a remote cluster.

Local node¶

On the same node as you are installing Scylla Manager, download and install Scylla Server package. You can either use Scylla Enterprise or Scylla Open Source. There is no need to run the Scylla setup, it is taken care of later, by the scyllamgr_setup script. When it’s installed you can jump to Run the scyllamgr_setup script section.

Remote cluster¶

Scylla Manager configuration file /etc/scylla-manager/scylla-manager.yaml contains a database configuration section.

# Scylla Manager database, used to store management data.
database:
  hosts:
    - 127.0.0.1
# Override default 9042 CQL port
#  port: 5555
#
# Enable or disable client/server encryption.
#  ssl: false
#
# Database credentials.
#  user: user
#  password: password
#
# Local datacenter name, specify if using a remote, multi-dc cluster.
#  local_dc:
#
# Database connection timeout.
#  timeout: 600ms
#
# Keyspace for management data, for create statement see /etc/scylla-manager/create_keyspace.cql.tpl.
#  keyspace: scylla_manager
#  replication_factor: 1

Using an editor open the file and change relevant parameters.

Procedure

  1. Edit the hosts parameter, change the IP address to the IP address or addressees of the remote cluster.

  2. If authentication is needed, uncomment and edit the user and password parameters.

  3. If it’s a single DC cluster, uncomment and edit the replication_factor parameter to match the required replication factor. This would use SimpleStrategy to create a Scylla Manager keyspace, refer to Scylla Architecture - Fault Tolerance for more information on replication.

  4. If it’s a multi DC cluster, create a keyspace named scylla_manager yourself. You can use a different keyspace name, just remember to adjust the keyspace parameter value. Set local_dc parameter to DC the closest to Scylla Manager Server.

  5. If client/server encryption is enabled, uncomment and set the ssl parameter to true. Additional SSL configuration options can be set in the ssl configuration section.

# Optional custom client/server encryption options.
#ssl:
# CA certificate used to validate server cert. If not set will use he host's root CA set.
#  cert_file:
#
# Verify the hostname and server cert.
#  validate: true
#
# Client certificate and key in PEM format. It has to be provided when
# client_encryption_options.require_client_auth=true is set on server.
#  user_cert_file:
#  user_key_file

Sample configuration of Scylla Manager working with a remote cluster with authentication and replication factor 3 could look like this.

database:
  hosts:
    - 198.100.51.11
    - 198.100.51.12
  user: user
  password: password
  replication_factor: 3

Run the scyllamgr_setup script¶

The Scylla Manager setup script automates configuration of Scylla Manager by asking you some questions. It can be run in non-interactive mode by using flags.

scyllamgr_setup -h
Usage: scyllamgr_setup [-y][--no-scylla-setup][--no-enable-service][--no-check-for-updates]

Options:
  -y, --assume-yes          assume that the answer to any question which would be asked is yes
  --no-scylla-setup         skip setting up and enabling local Scylla instance as a storage backend for Scylla Manager
  --no-enable-service       skip enabling service
  --no-check-for-updates    skip enabling periodic check for updates
  -h, --help                print this help

Interactive mode is enabled when no flags are provided.

Run the scyllamgr_setup script to configure the service.

Enable bash script completion¶

Enable bash completion for sctool (the Scylla Manager CLI) in the current bash session. Alternatively, you can just open a new terminal.

source /etc/bash_completion.d/sctool.bash

Start ScyllaDB Manager service¶

Scylla Manager integrates with systemd and can be started and stopped using systemctl command.

Procedure

  1. Start the Scylla Manager server service.

    sudo systemctl start scylla-manager.service
    
  2. Verify the Scylla Manager server service is running.

    sudo systemctl status scylla-manager.service -l
    ● scylla-manager.service - Scylla Manager Server
       Loaded: loaded (/usr/lib/systemd/system/scylla-manager.service; enabled; vendor preset: disabled)
       Active: active (running) since Wed 2019-10-30 11:00:01 UTC; 20s ago
     Main PID: 5805 (scylla-manager)
       CGroup: /system.slice/scylla-manager.service
               └─5805 /usr/bin/scylla-manager
    

    Note

    The first time you start Scylla Manager it may take a while. It creates a database schema. Follow the logs to see the progress.

  3. Confirm sctool is running by displaying the sctool version.

    sctool version
    Client version: 2.1-0.20200401.ce91f2ad
    Server version: 2.1-0.20200401.ce91f2ad
    

Next steps¶

  • Install Scylla Manager Agent

Was this page helpful?

PREVIOUS
Docker
NEXT
Install ScyllaDB Manager Agent
  • Create an issue
  • Edit this page

On this page

  • Install ScyllaDB Manager
    • System requirements
    • Install package
    • Configure storage
      • Local node
      • Remote cluster
    • Run the scyllamgr_setup script
    • Enable bash script completion
    • Start ScyllaDB Manager service
    • Next steps
Scylla Manager
  • 3.3
    • master
    • 3.5
    • 3.4
    • 3.3
  • Docker
  • Install ScyllaDB Manager
  • Install ScyllaDB Manager Agent
  • ScyllaDB Manager Upgrade
  • Add a Cluster
  • Backup
    • Setup Amazon S3
    • Setup S3 compatible storage
    • Setup Google Cloud Storage
    • Setup Azure Blob Storage
    • Examples
    • Specification
  • Restore
    • Restore tables
    • Restore schema for ScyllaDB 6.0/2024.2 or newer
    • Restore schema for ScyllaDB 5.4/2024.1 or older
    • Examples
    • Compatibility Matrix
  • Repair
    • Repair faster
    • Repair slower
    • Examples
  • Health Check
  • CLI sctool
    • Environment variables
    • Completion
    • Download files
    • Backup
    • Restore
    • Cluster
    • Info
    • Progress
    • Repair
    • Start
    • Status
    • Stop
    • Suspend & Resume
    • Tasks
    • Version
  • Configuration Files
    • Scylla Manager Config
    • Scylla Manager Agent Config
  • Swagger File
  • ScyllaDB Monitoring
  • Troubleshooting
  • Slack
Docs Tutorials University Contact Us About Us
© 2025, ScyllaDB. All rights reserved. | Terms of Service | Privacy Policy | ScyllaDB, and ScyllaDB Cloud, are registered trademarks of ScyllaDB, Inc.
Last updated on 07 May 2025.
Powered by Sphinx 7.4.7 & ScyllaDB Theme 1.8.6