From 036eb97f03a30ea07708ab950f7723dd0e874053 Mon Sep 17 00:00:00 2001 From: Thalian Date: Mon, 6 Jun 2022 10:32:35 +0200 Subject: [PATCH] [DOCS] #5960 - FAQ: Full quota / full disk --- docs/faq.rst | 38 ++++++++++++++++++++++++++++++++++++++ docs/quickstart.rst | 2 ++ 2 files changed, 40 insertions(+) diff --git a/docs/faq.rst b/docs/faq.rst index f77aa4950..cd6a055f0 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -1255,6 +1255,44 @@ It may be useful to set ``BORG_RELOCATED_REPO_ACCESS_IS_OK=yes`` to avoid the prompts when renaming multiple repositories or in a non-interactive context such as a script. See :doc:`deployment` for an example. +The repository quota size is reached, what can I do? +---------------------------------------------------- + +The simplest solution is to increase or disable the quota and resume the backup: + +:: + + borg config /path/to/repo storage_quota 0 + +If you are bound to the quota, you have to free repository space. The first to +try is running :ref:`borg_compact` to free unused backup space (see also +:ref:`separate_compaction`): + +:: + + borg compact /path/to/repo + +If your repository is already compacted, run :ref:`borg_prune` or +:ref:`borg_delete` to delete archives that you do not need anymore, and then run +``borg compact`` again. + +My backup disk is full, what can I do? +-------------------------------------- + +Borg cannot work if you really have zero free space on the backup disk, so the +first thing you must do is deleting some files to regain free disk space. See +:ref:`about_free_space` for further details. + +Some Borg commands that do not change the repository might work under disk-full +conditions, but generally this should be avoided. If your backup disk is already +full when Borg starts a write command like `borg create`, it will abort +immediately and the repository will stay as-is. + +If you run a backup that stops due to a disk running full, Borg will roll back, +delete the new new segment file and thus freeing disk space automatically. There +may be a checkpoint archive left that has been saved before the disk got full. +You can keep it to speed up the next backup or delete it to get back more disk +space. Miscellaneous ############# diff --git a/docs/quickstart.rst b/docs/quickstart.rst index a306783a8..e535e3871 100644 --- a/docs/quickstart.rst +++ b/docs/quickstart.rst @@ -26,6 +26,8 @@ repositories contain data blocks and a manifest tracking which blocks are in eac archive. If some data hasn't changed from one backup to another, Borg can simply reference an already uploaded data chunk (deduplication). +.. _about_free_space: + Important note about free space -------------------------------