177 lines
8 KiB
HTML
177 lines
8 KiB
HTML
|
<!DOCTYPE HTML>
|
||
|
<html>
|
||
|
<head>
|
||
|
<meta charset="UTF-8">
|
||
|
<link rel="stylesheet" href="https://norgbackup.net/main.css">
|
||
|
<link rel="stylesheet" href="https://norgbackup.net/norg.css">
|
||
|
<link rel="icon" href="https://norgbackup.net/favicon.png">
|
||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1">
|
||
|
<title> Norg | Create a Backup </title>
|
||
|
</head>
|
||
|
<body>
|
||
|
|
||
|
<main>
|
||
|
|
||
|
<nav>
|
||
|
<a href="https://norgbackup.net">
|
||
|
<img src="https://norgbackup.net/norg-logo.png" alt="logo"/>
|
||
|
</a>
|
||
|
<a href="javascript:void(0);" onclick="burger()" id="mobile" class="ms-Icon--GlobalNavButton"></a>
|
||
|
<div id="trees">
|
||
|
<input class="tree-toggle" type="checkbox" id="introduction"
|
||
|
/>
|
||
|
<label class="tree-toggle-label"
|
||
|
for="introduction">Introduction</label>
|
||
|
|
||
|
<ul class="subtree">
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/introduction/about-norg/">About Norg</a>
|
||
|
</li>
|
||
|
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/introduction/system-compatibility/">System Compatibility</a>
|
||
|
</li>
|
||
|
|
||
|
</ul>
|
||
|
<input class="tree-toggle" type="checkbox" id="reference-guides"
|
||
|
/>
|
||
|
<label class="tree-toggle-label"
|
||
|
for="reference-guides">Reference Guides</label>
|
||
|
|
||
|
<ul class="subtree">
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/reference/example-configuration/">Example Configuration</a>
|
||
|
</li>
|
||
|
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/reference/command-line/">Command Line Reference</a>
|
||
|
</li>
|
||
|
|
||
|
</ul>
|
||
|
<input class="tree-toggle" type="checkbox" id="usage"
|
||
|
checked/>
|
||
|
<label class="tree-toggle-label"
|
||
|
for="usage">Usage</label>
|
||
|
|
||
|
<ul class="subtree">
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/usage/setup/">Setting up Norg</a>
|
||
|
</li>
|
||
|
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/usage/configuration/">Configuring Norg</a>
|
||
|
</li>
|
||
|
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/usage/redundancy/">Backup Redundancy</a>
|
||
|
</li>
|
||
|
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/usage/initialize/">Initialize Repositories</a>
|
||
|
</li>
|
||
|
|
||
|
<li class="active">
|
||
|
<a href="https://norgbackup.net/usage/create-a-backup/">Create a Backup</a>
|
||
|
</li>
|
||
|
|
||
|
|
||
|
|
||
|
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/usage/inspect-your-backups/">Inspect your Backups</a>
|
||
|
</li>
|
||
|
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/usage/monitoring-backup-jobs/">Knowing your Backup has Run</a>
|
||
|
</li>
|
||
|
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/usage/extract-a-backup/">Extract/Restore a Backup</a>
|
||
|
</li>
|
||
|
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/usage/before-and-after-actions/">Before and After Actions</a>
|
||
|
</li>
|
||
|
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/usage/both-borg-and-restic/">Using both Borg and Restic</a>
|
||
|
</li>
|
||
|
|
||
|
</ul>
|
||
|
<input class="tree-toggle" type="checkbox" id="download"
|
||
|
/>
|
||
|
<label class="tree-toggle-label"
|
||
|
for="download">Download</label>
|
||
|
|
||
|
<ul class="subtree">
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/download/download-norg/">Download Norg</a>
|
||
|
</li>
|
||
|
|
||
|
</ul>
|
||
|
<input class="tree-toggle" type="checkbox" id="contributing-to-norg"
|
||
|
/>
|
||
|
<label class="tree-toggle-label"
|
||
|
for="contributing-to-norg">Contributing to Norg</label>
|
||
|
|
||
|
<ul class="subtree">
|
||
|
<li >
|
||
|
<a href="https://norgbackup.net/contributing/contributing/">Contributing</a>
|
||
|
</li>
|
||
|
|
||
|
</ul>
|
||
|
</div>
|
||
|
</nav>
|
||
|
<article>
|
||
|
|
||
|
<div id="on_right">
|
||
|
<span id="search-ico" class="ms-Icon--Search"></span>
|
||
|
</div>
|
||
|
<div class="search-container">
|
||
|
<input id="search" type="search" placeholder="Search as you type...">
|
||
|
<div class="search-results">
|
||
|
<div class="search-results__header"></div>
|
||
|
<ul class="search-results__items"></ul>
|
||
|
</div>
|
||
|
</div>
|
||
|
<div id="wrap">
|
||
|
<h1>Create a Backup</h1>
|
||
|
|
||
|
<p>Now norg is configured and your repositories are created and initialized, it's
|
||
|
sensible to test everything is working. Run norg with the <code>create</code> command to start a backup like this:</p>
|
||
|
<pre data-lang="sh" style="background-color:#eff1f5;color:#4f5b66;" class="language-sh "><code class="language-sh" data-lang="sh"><span style="color:#bf616a;">norg -c</span><span> myconfig.toml create</span><span style="color:#bf616a;"> --stats
|
||
|
</span></code></pre>
|
||
|
<p>As the command runs, you should check the output of borg or restic to see if files
|
||
|
you expect to be backed up are being backed up.<br />
|
||
|
The <code>--stats</code> flag provides statistics of a borg backup once completed. It is
|
||
|
ignored for Restic backups.<br />
|
||
|
The <code>-c</code> or <code>--config</code> option is required, and must reference a norg configuration file.</p>
|
||
|
<h2 id="default-options">Default Options</h2>
|
||
|
<p>If you do not specify <code>create</code>, or any other option, norg will default to the <code>create</code> option anyway, so the above command can be simplified as so:</p>
|
||
|
<pre data-lang="sh" style="background-color:#eff1f5;color:#4f5b66;" class="language-sh "><code class="language-sh" data-lang="sh"><span style="color:#bf616a;">norg -c</span><span> myconfig.toml
|
||
|
</span></code></pre>
|
||
|
<p>With Restic, the terminology for creating a snapshot is <code>backup</code>. Norg has both <code>create</code> and <code>backup</code> as aliases to each other, so either will work as desired.</p>
|
||
|
|
||
|
|
||
|
</div>
|
||
|
<hr />
|
||
|
<h2>Help us improve this documentation.</h2>
|
||
|
<p>If you find an error, or think something could be explained better,
|
||
|
<a href="https://codeberg.org/pswilde/norgbackup/issues">raise an issue</a> to
|
||
|
send your feedback.</p>
|
||
|
<footer>
|
||
|
<p>Norg Backup Utility © 2024 Paul Wilde<br/>
|
||
|
Site created using <a href="https://getzola.org">Zola</a> using the
|
||
|
<a href="https://github.com/codeandmedia/zola_easydocs_theme">easydocs</a> theme.</p>
|
||
|
</footer>
|
||
|
</article>
|
||
|
</main>
|
||
|
|
||
|
|
||
|
<script type="text/javascript" src="https://norgbackup.net/elasticlunr.min.js" defer></script>
|
||
|
<script type="text/javascript" src="https://norgbackup.net/search_index.en.js" defer></script>
|
||
|
<script type="text/javascript" src="https://norgbackup.net/js.js" defer></script>
|
||
|
|
||
|
</body>
|
||
|
</html>
|