diff --git a/docs/faq.rst b/docs/faq.rst index d20eaa5b3..23dab5382 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -223,12 +223,25 @@ Yes, |project_name| supports resuming backups. During a backup a special checkpoint archive named ``.checkpoint`` is saved every checkpoint interval (the default value for this is 5 -minutes) containing all the data backed-up until that point. This means +minutes) containing all the data backed-up until that point. This checkpoint +archive is a valid archive, but it is only a partial backup. Having it +in the repo until a successful, full backup is completed is useful because it +references all the transmitted chunks up to the checkpoint time. This means that at most worth of data needs to be retransmitted -if a backup needs to be restarted. +if you restart the backup. + +If a backup was interrupted, you do not need to do any special considerations, +just invoke ``borg create`` as you always do. You may use the same archive name +as in previous attempt or a different one (e.g. if you always include the current +datetime), it does not matter. +|project_name| always does full single-pass backups, so it will start again +from the beginning - but it will be much faster, because some of the data was +already stored into the repo (and is still referenced by the checkpoint +archive), so it does not need to get transmitted and stored again. Once your backup has finished successfully, you can delete all -``.checkpoint`` archives. +``.checkpoint`` archives. If you run ``borg prune``, it will +also care for deleting unneeded checkpoints. If it crashes with a UnicodeError, what can I do? -------------------------------------------------