<?xml version="1.0" encoding="utf-8"?>
<!--
SPDX-License-Identifier: CC-BY-SA-4.0
SPDX-FileCopyrightText: Michael Terry
-->

<page xmlns="http://projectmallard.org/1.0/"
      xmlns:its="http://www.w3.org/2005/11/its"
      its:version="2.0"
      type="topic" style="task"
      id="restore-full">
<info>
  <desc>Recover lost files</desc>
  <link type="guide" xref="index#restore"/>
  <credit type="author" its:translate="no">
    <name>Michael Terry</name>
  </credit>
  <license href="http://creativecommons.org/licenses/by-sa/4.0/"><p>Creative Commons Attribution-Share Alike 4.0 Unported License</p></license>
</info>
<title>Restoring</title>
<section id="scan">
<title>Scanning for Backups</title>
<p>Each time a new backup happens, it adds a new "snapshot" of your files. Each snapshot has its own record of files at the time of backup.</p>
<p>In order to browse and restore from an existing backup, we must first scan the available backups and pick one to examine.</p>

<section id="fresh">
<title>Fresh Install</title>
<p>If you haven’t used <app>Déjà Dup</app> on your computer before (for example, if you are working on a freshly installed system), you have to do some initial setup.</p>
<steps>
  <item><p>Open <gui>Backups</gui>.</p></item>
  <item><p>Click on the <gui style="button">Restore From a Previous Backup…</gui> button.</p></item>
  <item><p>A restore dialog will appear asking where your backup files are stored (your <gui>Backup location</gui>).</p></item>
  <item><p>Click <gui style="button">Search</gui>.</p></item>
  <item><p>Wait for <app>Déjà Dup</app> to scan the backup location.</p></item>
</steps>
</section>

<section id="existing">
<title>Existing Install</title>
<p>If you are trying to restore a file from a previous backup on your computer, that’s easy too.</p>
<steps>
  <item><p>Open <gui>Backups</gui>.</p></item>
  <item><p>Click on the <gui style="button">Browse Backups</gui> button.</p></item>
  <item><p>Wait for <app>Déjà Dup</app> to scan the backup location.</p></item>
</steps>
</section>

</section>

<section id="restore">
<title>Restore Files</title>
<p>Scroll the available backup dates and click the one you want to examine. Then one of two things will happen, depending on when you first made a backup.</p>

<section id="restic">
<title>Restic</title>
<p>If your backups were first created with a modern version of <app>Déjà Dup</app> (49.0 or later), it made Restic backups.</p>
<p>In that case, a file manager window will appear. You can open files directly or drag and drop them to the rest of your file system to restore them.</p>
</section>

<section id="duplicity">
<title>Duplicity</title>
<p>If your backups were first created with an older version of <app>Déjà Dup</app> (48.2 or earlier), it made Duplicity backups.</p>
<p>In that case, you'll see a built-in file browser. Select the files you want to restore, click <gui>Restore</gui>, and choose the destination.</p>
</section>

<note>
<p>If you hit problems restoring, there are <link xref="restore-worst-case">more drastic things</link> you can try.</p>
</note>
</section>
</page>
