From 102ea6da2be655efeb945b0a81d0c1d225f780af Mon Sep 17 00:00:00 2001 From: Adrian Mastronardi Date: Tue, 24 Feb 2026 00:06:38 +0100 Subject: [PATCH] docs: document backup progress bar fields (#4258) --- doc/040_backup.rst | 20 +++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/doc/040_backup.rst b/doc/040_backup.rst index 9504a223d..614d58ee0 100644 --- a/doc/040_backup.rst +++ b/doc/040_backup.rst @@ -48,9 +48,23 @@ some of the data was duplicate and restic was able to efficiently reduce it. The data compression also managed to compress the data down to 1.103 GiB. If you don't pass the ``--verbose`` option, restic will print less data. You'll -still get a nice live status display. Be aware that the live status shows the -processed files and not the transferred data. Transferred volume might be lower -(due to de-duplication) or higher. +still get a nice live status display that looks like this: + +.. code-block:: console + + [0:34] 2.96% 867 files 5.046 GiB, total 307867 files 170.438 GiB, 0 errors ETA 18:35 + +The progress bar shows, from left to right: elapsed time, progress in percent, +the number of files already processed and their size on the local filesystem, +followed by the total expected file count and size for the whole backup (these +totals come from the initial scan used for progress estimation, which can be +disabled with ``--no-scan``). Next is a counter for the number of files that +caused errors (these are logged above the progress bar), and finally an +estimated time of completion. The file paths displayed below the progress bar +are the files currently being read by restic. + +Be aware that the live status shows the processed files and not the transferred +data. Transferred volume might be lower (due to de-duplication) or higher. On Windows, the ``--use-fs-snapshot`` option will use Windows' Volume Shadow Copy Service (VSS) when creating backups. Restic will transparently create a VSS