# Restore the cluster from a previously saved backup

The backup is normally restored on the Kubernetes cluster where it was made,
but [restoring it on a different Kubernetes-based environment with the installed Operator is also possible](backups-restore-to-new-cluster.md).

Following things are needed to restore a previously saved backup:

* Make sure that the cluster is running.
* Find out correct names for the **backup** and the **cluster**. Available
    backups can be listed with the following command:

    ``` {.bash data-prompt="$" }
    $ kubectl get psmdb-backup
    ```

    And the following command will list available clusters:

    ``` {.bash data-prompt="$" }
    $ kubectl get psmdb
    ```

!!! note

     If you have [configured storing operations logs for point-in-time recovery](backups-pitr.md),
     you will have possibility to roll back the cluster to a specific date and time. Otherwise,
     restoring backups without point-in-time recovery is the only option.

When the correct names for the backup and the cluster are known, backup
restoration can be done in the following way.

=== "Without point-in-time recovery"

    1. Set appropriate keys in the [deploy/backup/restore.yaml  :octicons-link-external-16:](https://github.com/percona/percona-server-mongodb-operator/blob/main/deploy/backup/restore.yaml) file.

        * set `spec.clusterName` key to the name of the target cluster to restore
            the backup on,

        * set `spec.backupName` key to the name of your backup,

            ```yaml
            apiVersion: psmdb.percona.com/v1
            kind: PerconaServerMongoDBRestore
            metadata:
              name: restore1
            spec:
              clusterName: my-cluster-name
              backupName: backup1
            ```

    2. After that, the actual restoration process can be started as follows:

        ``` {.bash data-prompt="$" }
        $ kubectl apply -f deploy/backup/restore.yaml
        ```

        !!! note

            Storing backup settings in a separate file can be replaced by
            passing its content to the `kubectl apply` command as follows:

            ```bash
            $ cat <<EOF | kubectl apply -f-
            apiVersion: psmdb.percona.com/v1
            kind: PerconaServerMongoDBRestore
            metadata:
              name: restore1
            spec:
              clusterName: my-cluster-name
              backupName: backup1
            EOF
            ```

=== "With point-in-time recovery"

    1. Set appropriate keys in the [deploy/backup/restore.yaml  :octicons-link-external-16:](https://github.com/percona/percona-server-mongodb-operator/blob/main/deploy/backup/restore.yaml) file.

        * set `spec.clusterName` key to the name of the target cluster to restore
            the backup on

        * set `spec.backupName` key to the name of your backup

        * put additional restoration parameters to the `pitr` section:

            * `type` key can be equal to one of the following options

                * `date` - roll back to specific date
                * `latest` - recover to the latest possible transaction

            * `date` key is used with `type=date` option and contains value in
                datetime format

        The resulting `restore.yaml` file may look as follows:

        ```yaml
        apiVersion: psmdb.percona.com/v1
        kind: PerconaServerMongoDBRestore
        metadata:
          name: restore1
        spec:
          clusterName: my-cluster-name
          backupName: backup1
          pitr:
            type: date
            date: YYYY-MM-DD hh:mm:ss
        ```

    2. Run the actual restoration process:

        ``` {.bash data-prompt="$" }
        $ kubectl apply -f deploy/backup/restore.yaml
        ```

        !!! note

            Storing backup settings in a separate file can be replaced by
            passing its content to the `kubectl apply` command as follows:

            ``` {.bash data-prompt="$" }
            $ cat <<EOF | kubectl apply -f-
            apiVersion: psmdb.percona.com/v1
            kind: PerconaServerMongoDBRestore
            metadata:
              name: restore1
            spec:
              clusterName: my-cluster-name
              backupName: backup1
              pitr:
                type: date
                date: YYYY-MM-DD hh:mm:ss
            EOF
            ```