mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-27 10:18:12 +00:00
df8205a4ba
Created with borg v1.1.0, so more up-to-date and split into different parts (install, basic, advanced)… Fixes https://github.com/borgbackup/borg/issues/669
53 lines
2.2 KiB
Bash
53 lines
2.2 KiB
Bash
# Here you'll see some basic commands to start working with borg.
|
||
# Note: This teaser screencast was made with borg version 1.1.0 – older or newer borg versions may behave differently.
|
||
# But let's start.
|
||
|
||
# First of all, you can always get help:
|
||
borg help
|
||
# These are a lot of commands, so better we start with a few:
|
||
# Let's create a repo on an external drive…
|
||
borg init --encryption=repokey /media/backup/borgdemo
|
||
# This uses the repokey encryption. You may look at "borg help init" or the online doc at https://borgbackup.readthedocs.io/ for other modes.
|
||
|
||
# So now, let's create our first (compressed) backup.
|
||
borg create --stats --progress --compression lz4 /media/backup/borgdemo::backup1 Wallpaper
|
||
|
||
# That's nice, so far.
|
||
# So let's add a new file…
|
||
echo "new nice file" > Wallpaper/newfile.txt
|
||
|
||
<up>
|
||
borg create --stats --progress --compression lz4 /media/backup/borgdemo::backup2 Wallpaper
|
||
|
||
# Wow, this was a lot faster!
|
||
# Notice the "Deduplicated size" for "This archive"!
|
||
# Borg recognized that most files did not change and deduplicated them.
|
||
|
||
# But what happens, when we move a dir and create a new backup?
|
||
mv …
|
||
|
||
borg create --stats --progress --compression lz4 /media/backup/borgdemo::backup3 Wallpaper
|
||
|
||
# Still quite fast…
|
||
# But when you look at the "deduplicated file size" again, you see that borg also recognized that only the dir and not the files changed in this backup.
|
||
|
||
# Now lets look into a repo.
|
||
borg list /media/backup/borgdemo
|
||
|
||
# You'll see a list of all backups.
|
||
# You can also use the same command to look into an archive. But we better filter the output here:
|
||
borg list /media/backup/borgdemo::backup3 | grep 'deer.jpg'
|
||
|
||
# Oh, we found our picture. Now extract it…
|
||
mv Wallpaper Wallpaper.orig
|
||
borg extract /media/backup/borgdemo::backup3 <copy>
|
||
|
||
# And check that it's the same:
|
||
diff -s Wallpaper/deer.jpg Wallpaper.orig/deer.jpg
|
||
|
||
# And, of course, we can also create remote repos via ssh when borg is setup there. This command creates a new remote repo in a subdirectory called "demo":
|
||
borg init --encryption=repokey borgdemo@remoteserver.example:./demo
|
||
|
||
# Easy, isn't it? That's all you need to know for basic usage.
|
||
# If you want to see more, have a look at the screencast showing the "advanced usage".
|
||
# In any case, enjoy using borg!
|