|
Server : LiteSpeed System : Linux srv104790275 5.15.0-161-generic #171-Ubuntu SMP Sat Oct 11 08:17:01 UTC 2025 x86_64 User : dewac4139 ( 1077) PHP Version : 8.0.30 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory : /usr/share/doc/restic/html/ |
Upload File : |
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Restoring from backup — restic 0.12.1
documentation</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/restic.css" type="text/css" />
<link rel="shortcut icon" href="_static/favicon.ico"/>
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Removing backup snapshots" href="060_forget.html" />
<link rel="prev" title="Working with repositories" href="045_working_with_repos.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> restic
<img src="_static/logo.png" class="logo" alt="Logo"/>
</a>
<div class="version">
0.12.1
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="010_introduction.html">Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="020_installation.html">Installation</a></li>
<li class="toctree-l1"><a class="reference internal" href="030_preparing_a_new_repo.html">Preparing a new repository</a></li>
<li class="toctree-l1"><a class="reference internal" href="040_backup.html">Backing up</a></li>
<li class="toctree-l1"><a class="reference internal" href="045_working_with_repos.html">Working with repositories</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Restoring from backup</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#restoring-from-a-snapshot">Restoring from a snapshot</a></li>
<li class="toctree-l2"><a class="reference internal" href="#restore-using-mount">Restore using mount</a></li>
<li class="toctree-l2"><a class="reference internal" href="#printing-files-to-stdout">Printing files to stdout</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="060_forget.html">Removing backup snapshots</a></li>
<li class="toctree-l1"><a class="reference internal" href="070_encryption.html">Encryption</a></li>
<li class="toctree-l1"><a class="reference internal" href="075_scripting.html">Scripting</a></li>
<li class="toctree-l1"><a class="reference internal" href="080_examples.html">Examples</a></li>
<li class="toctree-l1"><a class="reference internal" href="090_participating.html">Participating</a></li>
<li class="toctree-l1"><a class="reference internal" href="100_references.html">References</a></li>
<li class="toctree-l1"><a class="reference internal" href="110_talks.html">Talks</a></li>
<li class="toctree-l1"><a class="reference internal" href="faq.html">FAQ</a></li>
<li class="toctree-l1"><a class="reference internal" href="manual_rest.html">Manual</a></li>
<li class="toctree-l1"><a class="reference internal" href="developer_information.html">Developer Information</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">restic</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home"></a> »</li>
<li>Restoring from backup</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/050_restore.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="restoring-from-backup">
<h1>Restoring from backup<a class="headerlink" href="#restoring-from-backup" title="Permalink to this headline">¶</a></h1>
<section id="restoring-from-a-snapshot">
<h2>Restoring from a snapshot<a class="headerlink" href="#restoring-from-a-snapshot" title="Permalink to this headline">¶</a></h2>
<p>Restoring a snapshot is as easy as it sounds, just use the following
command to restore the contents of the latest snapshot to
<code class="docutils literal notranslate"><span class="pre">/tmp/restore-work</span></code>:</p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>restic -r /srv/restic-repo restore <span class="m">79766175</span> --target /tmp/restore-work
<span class="go">enter password for repository:</span>
<span class="go">restoring <Snapshot of [/home/user/work] at 2015-05-08 21:40:19.884408621 +0200 CEST> to /tmp/restore-work</span>
</pre></div>
</div>
<p>Use the word <code class="docutils literal notranslate"><span class="pre">latest</span></code> to restore the last backup. You can also combine
<code class="docutils literal notranslate"><span class="pre">latest</span></code> with the <code class="docutils literal notranslate"><span class="pre">--host</span></code> and <code class="docutils literal notranslate"><span class="pre">--path</span></code> filters to choose the last
backup for a specific host, path or both.</p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>restic -r /srv/restic-repo restore latest --target /tmp/restore-art --path <span class="s2">"/home/art"</span> --host luigi
<span class="go">enter password for repository:</span>
<span class="go">restoring <Snapshot of [/home/art] at 2015-05-08 21:45:17.884408621 +0200 CEST> to /tmp/restore-art</span>
</pre></div>
</div>
<p>Use <code class="docutils literal notranslate"><span class="pre">--exclude</span></code> and <code class="docutils literal notranslate"><span class="pre">--include</span></code> to restrict the restore to a subset of
files in the snapshot. For example, to restore a single file:</p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>restic -r /srv/restic-repo restore <span class="m">79766175</span> --target /tmp/restore-work --include /work/foo
<span class="go">enter password for repository:</span>
<span class="go">restoring <Snapshot of [/home/user/work] at 2015-05-08 21:40:19.884408621 +0200 CEST> to /tmp/restore-work</span>
</pre></div>
</div>
<p>This will restore the file <code class="docutils literal notranslate"><span class="pre">foo</span></code> to <code class="docutils literal notranslate"><span class="pre">/tmp/restore-work/work/foo</span></code>.</p>
<p>You can use the command <code class="docutils literal notranslate"><span class="pre">restic</span> <span class="pre">ls</span> <span class="pre">latest</span></code> or <code class="docutils literal notranslate"><span class="pre">restic</span> <span class="pre">find</span> <span class="pre">foo</span></code> to find the
path to the file within the snapshot. This path you can then pass to
<code class="docutils literal notranslate"><span class="pre">--include</span></code> in verbatim to only restore the single file or directory.</p>
<p>There are case insensitive variants of <code class="docutils literal notranslate"><span class="pre">--exclude</span></code> and <code class="docutils literal notranslate"><span class="pre">--include</span></code> called
<code class="docutils literal notranslate"><span class="pre">--iexclude</span></code> and <code class="docutils literal notranslate"><span class="pre">--iinclude</span></code>. These options will behave the same way but
ignore the casing of paths.</p>
</section>
<section id="restore-using-mount">
<h2>Restore using mount<a class="headerlink" href="#restore-using-mount" title="Permalink to this headline">¶</a></h2>
<p>Browsing your backup as a regular file system is also very easy. First,
create a mount point such as <code class="docutils literal notranslate"><span class="pre">/mnt/restic</span></code> and then use the following
command to serve the repository with FUSE:</p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>mkdir /mnt/restic
<span class="gp">$ </span>restic -r /srv/restic-repo mount /mnt/restic
<span class="go">enter password for repository:</span>
<span class="go">Now serving /srv/restic-repo at /mnt/restic</span>
<span class="go">When finished, quit with Ctrl-c or umount the mountpoint.</span>
</pre></div>
</div>
<p>Mounting repositories via FUSE is only possible on Linux, macOS and FreeBSD.
On Linux, the <code class="docutils literal notranslate"><span class="pre">fuse</span></code> kernel module needs to be loaded and the <code class="docutils literal notranslate"><span class="pre">fusermount</span></code>
command needs to be in the <code class="docutils literal notranslate"><span class="pre">PATH</span></code>. On macOS, you need <a class="reference external" href="https://osxfuse.github.io/">FUSE for macOS</a>. On FreeBSD, you may need to install FUSE
and load the kernel module (<code class="docutils literal notranslate"><span class="pre">kldload</span> <span class="pre">fuse</span></code>).</p>
<p>Restic supports storage and preservation of hard links. However, since
hard links exist in the scope of a filesystem by definition, restoring
hard links from a fuse mount should be done by a program that preserves
hard links. A program that does so is <code class="docutils literal notranslate"><span class="pre">rsync</span></code>, used with the option
–hard-links.</p>
</section>
<section id="printing-files-to-stdout">
<h2>Printing files to stdout<a class="headerlink" href="#printing-files-to-stdout" title="Permalink to this headline">¶</a></h2>
<p>Sometimes it’s helpful to print files to stdout so that other programs can read
the data directly. This can be achieved by using the <cite>dump</cite> command, like this:</p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>restic -r /srv/restic-repo dump latest production.sql <span class="p">|</span> mysql
</pre></div>
</div>
<p>If you have saved multiple different things into the same repo, the <code class="docutils literal notranslate"><span class="pre">latest</span></code>
snapshot may not be the right one. For example, consider the following
snapshots in a repo:</p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>restic -r /srv/restic-repo snapshots
<span class="go">ID Date Host Tags Directory</span>
<span class="go">----------------------------------------------------------------------</span>
<span class="go">562bfc5e 2018-07-14 20:18:01 mopped /home/user/file1</span>
<span class="go">bbacb625 2018-07-14 20:18:07 mopped /home/other/work</span>
<span class="go">e922c858 2018-07-14 20:18:10 mopped /home/other/work</span>
<span class="go">098db9d5 2018-07-14 20:18:13 mopped /production.sql</span>
<span class="go">b62f46ec 2018-07-14 20:18:16 mopped /home/user/file1</span>
<span class="go">1541acae 2018-07-14 20:18:18 mopped /home/other/work</span>
<span class="go">----------------------------------------------------------------------</span>
</pre></div>
</div>
<p>Here, restic would resolve <code class="docutils literal notranslate"><span class="pre">latest</span></code> to the snapshot <code class="docutils literal notranslate"><span class="pre">1541acae</span></code>, which does
not contain the file we’d like to print at all (<code class="docutils literal notranslate"><span class="pre">production.sql</span></code>). In this
case, you can pass restic the snapshot ID of the snapshot you like to restore:</p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>restic -r /srv/restic-repo dump 098db9d5 production.sql <span class="p">|</span> mysql
</pre></div>
</div>
<p>Or you can pass restic a path that should be used for selecting the latest
snapshot. The path must match the patch printed in the “Directory” column,
e.g.:</p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>restic -r /srv/restic-repo dump --path /production.sql latest production.sql <span class="p">|</span> mysql
</pre></div>
</div>
<p>It is also possible to <code class="docutils literal notranslate"><span class="pre">dump</span></code> the contents of a whole folder structure to
stdout. To retain the information about the files and folders Restic will
output the contents in the tar (default) or zip format:</p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>restic -r /srv/restic-repo dump latest /home/other/work > restore.tar
</pre></div>
</div>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$ </span>restic -r /srv/restic-repo dump -a zip latest /home/other/work > restore.zip
</pre></div>
</div>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="045_working_with_repos.html" class="btn btn-neutral float-left" title="Working with repositories" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="060_forget.html" class="btn btn-neutral float-right" title="Removing backup snapshots" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>© Copyright 2024, restic authors.</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>