diff --git a/doc/040_backup.rst b/doc/040_backup.rst index 157296dc2..782aa7030 100644 --- a/doc/040_backup.rst +++ b/doc/040_backup.rst @@ -654,7 +654,8 @@ environment variables. The following lists these environment variables: RESTIC_PACK_SIZE Target size for pack files RESTIC_READ_CONCURRENCY Concurrency for file reads - TMPDIR Location for temporary files + TMPDIR Location for temporary files (except Windows) + TMP Location for temporary files (only Windows) AWS_ACCESS_KEY_ID Amazon S3 access key ID AWS_SECRET_ACCESS_KEY Amazon S3 secret access key diff --git a/doc/047_tuning_backup_parameters.rst b/doc/047_tuning_backup_parameters.rst index a6b998cfe..650f111be 100644 --- a/doc/047_tuning_backup_parameters.rst +++ b/doc/047_tuning_backup_parameters.rst @@ -99,7 +99,8 @@ to a 16 MiB pack size. The side effect of increasing the pack size is requiring more disk space for temporary pack files created before uploading. The space must be available in the system default temp -directory, unless overwritten by setting the ``$TMPDIR`` environment variable. In addition, +directory, unless overwritten by setting the ``$TMPDIR`` (except Windows) environment +variable (on Windows use ``$TMP`` or ``$TEMP``). In addition, depending on the backend the memory usage can also increase by a similar amount. Restic requires temporary space according to the pack size, multiplied by the number of backend connections plus one. For example, if the backend uses 5 connections (the default diff --git a/doc/manual_rest.rst b/doc/manual_rest.rst index bf9554e04..34116fe86 100644 --- a/doc/manual_rest.rst +++ b/doc/manual_rest.rst @@ -408,9 +408,12 @@ Temporary files During some operations (e.g. ``backup`` and ``prune``) restic uses temporary files to store data. These files will, by default, be saved to the system's temporary directory, on Linux this is usually located in -``/tmp/``. The environment variable ``TMPDIR`` can be used to specify a -different directory, e.g. to use the directory ``/var/tmp/restic-tmp`` -instead of the default, set the environment variable like this: +``/tmp/``. To specify a different directory for temporary files, set +the appropriate environment variable. On non-Windows operating systems, +use the ``TMPDIR`` environment variable. On Windows, use either the +``TMP`` or ``TEMP`` environment variable. For example, to use the +directory ``/var/tmp/restic-tmp`` instead of the default, set the +environment variable as follows: .. code-block:: console