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

Caution

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

CLI sctool¶

sctool is a Command Line Interface (CLI) for the ScyllaDB Manager server. The server communicates with managed ScyllaDB clusters and performs cluster-wide operations such as automatic repair and backup.

Syntax¶

sctool <command> [flags] [global flags]

Note

Flags that have default values must be set with =.

See the left pane menu for commands.

Examples¶

List tasks with set properties¶

sctool tasks -c prod-cluster --show-properties
╭─────────────────────────────────────────────┬──────────────┬────────┬───────────────┬─────────┬───────┬─────────────────────────┬────────────┬─────────┬─────────────────────────┬───────────────────────────╮
│ Task                                        │ Schedule     │ Window │ Timezone      │ Success │ Error │ Last Success            │ Last Error │ Status  │ Next                    │ Properties                │
├─────────────────────────────────────────────┼──────────────┼────────┼───────────────┼─────────┼───────┼─────────────────────────┼────────────┼─────────┼─────────────────────────┼───────────────────────────┤
│ healthcheck/cql                             │ @every 15s   │        │ Europe/Warsaw │ 2       │ 0     │ 08 Sep 23 11:05:07 CEST │            │ DONE    │ 08 Sep 23 11:05:22 CEST │ mode: cql                 │
│ healthcheck/rest                            │ @every 1m0s  │        │ Europe/Warsaw │ 0       │ 0     │                         │            │ NEW     │ 08 Sep 23 11:05:37 CEST │ mode: rest                │
│ healthcheck/alternator                      │ @every 15s   │        │ Europe/Warsaw │ 2       │ 0     │ 08 Sep 23 11:05:07 CEST │            │ DONE    │ 08 Sep 23 11:05:22 CEST │ mode: alternator          │
│ repair/all-weekly                           │ 0 23 * * SAT │        │ Europe/Warsaw │ 0       │ 0     │                         │            │ NEW     │ 09 Sep 23 23:00:00 CEST │                           │
│ repair/e8552c59-dfd3-4b2e-ab58-8920b6d0662c │              │        │ Europe/Warsaw │ 0       │ 0     │                         │            │ RUNNING │                         │ intensity: 5, parallel: 7 │
╰─────────────────────────────────────────────┴──────────────┴────────┴───────────────┴─────────┴───────┴─────────────────────────┴────────────┴─────────┴─────────────────────────┴───────────────────────────╯

Disable repair task¶

sctool repair update -c prod-cluster repair/all-weekly --enabled=false

List also the disabled tasks¶

Note that disabled tasks are prefixed with *.

sctool tasks -c prod-cluster -a
╭─────────────────────────────────────────────┬──────────────┬────────┬───────────────┬─────────┬───────┬─────────────────────────┬────────────┬────────┬─────────────────────────╮
│ Task                                        │ Schedule     │ Window │ Timezone      │ Success │ Error │ Last Success            │ Last Error │ Status │ Next                    │
├─────────────────────────────────────────────┼──────────────┼────────┼───────────────┼─────────┼───────┼─────────────────────────┼────────────┼────────┼─────────────────────────┤
│ healthcheck/cql                             │ @every 15s   │        │ Europe/Warsaw │ 288     │ 0     │ 08 Sep 23 12:16:37 CEST │            │ DONE   │ 08 Sep 23 12:16:52 CEST │
│ healthcheck/rest                            │ @every 1m0s  │        │ Europe/Warsaw │ 72      │ 0     │ 08 Sep 23 12:16:37 CEST │            │ DONE   │ 08 Sep 23 12:17:37 CEST │
│ healthcheck/alternator                      │ @every 15s   │        │ Europe/Warsaw │ 288     │ 0     │ 08 Sep 23 12:16:37 CEST │            │ DONE   │ 08 Sep 23 12:16:52 CEST │
│ *repair/all-weekly                          │ 0 23 * * SAT │        │ Europe/Warsaw │ 0       │ 0     │                         │            │ NEW    │                         │
│ repair/e8552c59-dfd3-4b2e-ab58-8920b6d0662c │              │        │ Europe/Warsaw │ 1       │ 0     │ 08 Sep 23 11:05:56 CEST │            │ DONE   │                         │
╰─────────────────────────────────────────────┴──────────────┴────────┴───────────────┴─────────┴───────┴─────────────────────────┴────────────┴────────┴─────────────────────────╯

Enable repair task¶

sctool repair update -c prod-cluster repair/all-weekly --enabled=true

Download files from backup location¶

scylla-manager-agent download-files --location s3:my-bucket -p=10

Was this page helpful?

PREVIOUS
Health Check
NEXT
Environment variables
  • Create an issue
  • Edit this page

On this page

  • CLI sctool
    • Syntax
    • Examples
      • List tasks with set properties
      • Disable repair task
      • List also the disabled tasks
      • Enable repair task
      • Download files from backup location
Scylla Manager
  • master
    • master
    • 3.6
    • 3.5
    • 3.4
  • Docker
  • Install ScyllaDB Manager
  • Install ScyllaDB Manager Agent
  • ScyllaDB Manager Upgrade
  • Compatibility Matrix
  • 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
  • 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 04 September 2025.
Powered by Sphinx 7.4.7 & ScyllaDB Theme 1.8.8
Ask AI