1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
1. Before a backup can be made, a repository has to be initialized::
$ borg -r /path/to/repo repo-create --encryption=repokey-aes-ocb
2. Back up the ``~/src`` and ``~/Documents`` directories into an archive called
*docs*::
$ borg -r /path/to/repo create docs ~/src ~/Documents
3. The next day, create a new archive using the same archive name::
$ borg -r /path/to/repo create --stats docs ~/src ~/Documents
This backup will be much quicker and much smaller, since only new,
never-before-seen data is stored. The ``--stats`` option causes Borg to
output statistics about the newly created archive such as the deduplicated
size (the amount of unique data not shared with other archives)::
Repository: /path/to/repo
Archive name: docs
Archive fingerprint: bcd1b53f9b4991b7afc2b339f851b7ffe3c6d030688936fe4552eccc1877718d
Time (start): Sat, 2022-06-25 20:21:43
Time (end): Sat, 2022-06-25 20:21:43
Duration: 0.07 seconds
Utilization of maximum archive size: 0%
Number of files: 699
Original size: 31.14 MB
Deduplicated size: 502 B
4. List all archives in the repository::
$ borg -r /path/to/repo repo-list
docs Sat, 2022-06-25 20:21:14 [b80e24d2...b179f298]
docs Sat, 2022-06-25 20:21:43 [bcd1b53f...1877718d]
5. List the contents of the first archive::
$ borg -r /path/to/repo list aid:b80e24d2
drwxr-xr-x user group 0 Mon, 2016-02-15 18:22:30 home/user/Documents
-rw-r--r-- user group 7961 Mon, 2016-02-15 18:22:30 home/user/Documents/Important.doc
...
6. Restore the first archive by extracting the files relative to the current directory::
$ borg -r /path/to/repo extract aid:b80e24d2
7. Delete the first archive (please note that this does **not** free repository disk space)::
$ borg -r /path/to/repo delete aid:b80e24d2
Be careful if you use an archive NAME (and not an archive ID), as it might match multiple archives.
Always use ``--dry-run`` and ``--list`` first!
8. Recover disk space by compacting the segment files in the repository::
$ borg -r /path/to/repo compact -v
.. Note::
Borg is quiet by default (it defaults to WARNING log level).
You can use options like ``--progress`` or ``--list`` to get specific
reports during command execution. You can also add the ``-v`` (or
``--verbose`` or ``--info``) option to adjust the log level to INFO to
get other informational messages.
|
