---
name: "rdup-restore"
section: "1"
platform: "linux"
package: "rdup"
version: "0.6.0-1"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/rdup-restore"
---

# rdup-restore(1)

restore a filesystem from a specific backup directory

## NAME

rdup-restore - restore a filesystem from a specific backup directory

## SYNOPSIS

**rdup-restore** \[ *OPTION* \] SOURCE \[ SOURCE ... \] DIRECTORY

## DESCRIPTION

**rdup-restore** is a frontend to \`rdup-snap -R' and \`rdup'. It will restore everything from *SOURCE*s to *DIRECTORY*.

SOURCE can be a remote location (use the ssh:// syntax), if you use that syntax only one SOURCE can be used. When using this syntax the files are *pulled* from the remote server using 'ssh'.

There is no provisioning for **ssh** so unless you have configured **ssh** to work without a passphrase you will be asked to supply one. Also note that the PATH on the remote host should be set in such a way that all the rdup-utils can be found.

Restoring from a backup is as simple as:

      rdup-restore /vol/backup/elektron/200604/home /tmp/restore

Note: The restored files "inherit" the \`/vol/backup/elektron/200604' prefix. So the restored files are found in the directory: \`/tmp/home/vol/backup/elektron/200604/home'.

Multiple local sources are allowed, so that:

	rdup-restore /backup/home /backup/etc /tmp

Will restore both \`/backup/home' and '/backup/etc' to \`/tmp'.

## OPTIONS

- **-k keyfile**

  Decrypt the files while restoring with *keyfile*. This option inserts **rdup-crypt -d keyfile** in the pipeline. If both *-z* and *-k* are given files are first decrypted and then uncompressed.

- **-z**

  Decompress the files while restoring. This option inserts **rdup-gzip -d** in the pipeline. If both *-z* and *-k* are given a file is first decrypted and then unzipped. This  the opposite of what **rdup-simple** does.

- **-a**

  Enable extended attributes. Read the uid/gid to the extended user attributes r\_uid and r\_gid. See [rdup(1)](/rdup/1.md) for a more detailed explanation.

- **-g**

  Decrypt all files with GPG (using rdup-gpg). Note: without gpg-agent this isn't fun.

- **-v**

  Echo the files processed to standard error.

- **-h**

  Show a short help message.

- **-V**

  Show the version.

## EXAMPLES

### LOCAL RESTORE

Restoring from a local backup:

        rdup-restore /vol/backup/elektron/200604/home/miekg/bin /tmp/restore

### REMOTE RESTORE

Restoring from a remote server:

         rdup-restore ssh://miekg@remove/home/miekg/bin /tmp/restore

## SEE ALSO

[rdup(1)](/rdup/1.md) and [rdup-simple(1)](/rdup-simple/1.md).
