Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.
Yandex Managed Service for Valkey™
  • Getting started
    • All guides
      • Information about existing clusters
      • Creating a cluster
      • Updating cluster settings
      • Valkey™ version update
      • Working with Valkey™ models
      • Stopping and restarting a cluster
      • Managing cluster hosts
      • Migrating hosts to a different availability zone
      • Managing backups
      • Restoring data from an available host
      • Managing backup policies
      • Managing cluster access
      • Managing data tiering
      • Maintenance
      • Deleting a cluster
  • Access management
  • Inspections and recommendations
  • Pricing policy
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Public materials
  • Release notes
  • FAQ

In this article:

  • Prepare the cluster
  • Create a configuration file
  • Deploy the new instance
  • Test replication
  1. Step-by-step guides
  2. Clusters
  3. Restoring data from an available host

Restoring data from an available Yandex Managed Service for Valkey™ host

Written by
Yandex Cloud
Updated at November 16, 2026
View in Markdown
  • Prepare the cluster
  • Create a configuration file
  • Deploy the new instance
  • Test replication

If you have an available Yandex Managed Service for Valkey™ host, you can copy its data to a self-hosted Valkey™ instance using replication. You can deploy this instance in a different availability zone or another cloud.

Prepare the clusterPrepare the cluster

To establish a connection, you need a Yandex Managed Service for Valkey™ cluster with TLS enabled and a public IP address assigned to the available host. Configure public access to this host.

Create a configuration fileCreate a configuration file

Create a configuration file for the new Valkey™ instance:

replicaof <host_public_IP_address> 6380
tls-replication yes
tls-ca-cert-file /etc/valkey/tls/ca.crt
masteruser default
masterauth "<default_user_password>"

Specify the public IP address of the available host and the password for the source cluster default user.

Additional step. Obtain the CA certificate and save it to /etc/valkey/tls/ca.crt.

Note

TLS requirements. To initialize TLS in Valkey™, you also need a certificate and a private key for the new instance. Generate them using your preferred method and add them to the configuration:

tls-cert-file <path_to_certificate>
tls-key-file <private_key_path>

This requirement is described in the official Valkey™ guides.

Deploy the new instanceDeploy the new instance

Deploy Valkey™ using any preferred method. Use the same version as the source Yandex Managed Service for Valkey™ cluster and apply the configuration file you created.

Test replicationTest replication

  1. On the new instance, run the following command:

    valkey-cli INFO replication
    

    The output must show the following values:

    role:slave
    master_link_status:up
    
  2. On the source host, run INFO replication. Connection note. To connect to a host with TLS and authentication, run this command:

    valkey-cli --tls \
      -h <host_public_IP_address> -p 6380 \
      --cacert /etc/valkey/tls/ca.crt \
      --user default --askpass \
      INFO replication
    

    Enter the default user password. If the new instance is the only connected replica, the output will display:

    connected_slaves:1
    

    Note on the replica count. The connected_slaves field shows the total number of connected replicas. If the source already has replicas, this value will be greater than 1. For more information, see the INFO command description.

Was the article helpful?

Previous
Managing backups
Next
Managing backup policies
© 2026 Direct Cursus Technology L.L.C.