Merge pull request #7580 from nikolajlauridsen/add-temporary-file-location-docs

V17: Add documentation about temporary file location

Author: eshanrnh

17/umbraco-cms/fundamentals/setup/server-setup/load-balancing/load-balancing-backoffice.md

@@ -47,3 +47,17 @@ The Umbraco Backoffice uses SignalR for multiple things, including real-time upd
 ## Background Jobs
 
 If you have custom recurring background jobs that should only run on a single server, you'll need to implement `IDistributedBackgroundJob`. See [Scheduling documentation](../../../../reference/scheduling.md#background-jobs-when-load-balancing-the-backoffice) for more information.
+
+## Temporary File Storage
+
+When load balancing the backoffice, temporary files uploaded through `/umbraco/management/api/v1/temporary-file`, for instance media uploads, must be accessible across all server instances.
+
+Temporary files are saved to `umbraco/Data/TEMP/TemporaryFile/` by default.
+
+**Azure deployments using scale out:** No additional configuration is required, as the `umbraco` folder is shared between instances.
+
+**Other Environments:** Configure a shared storage location using [the `Umbraco:CMS:Hosting:TemporaryFileUploadLocation` setting.](../../../../reference/configuration/hostingsettings.md#temporary-file-upload-location)
+
+Ensure this path points to a location accessible by all server instances, such as a shared drive or volume.
+
+**Advanced Scenarios:** You can implement a custom `ITemporaryFileRepository` for external storage solutions such as Azure Blob Storage.

17/umbraco-cms/reference/configuration/hostingsettings.md

@@ -14,6 +14,7 @@ A full configuration with default values can be seen here:
     "Hosting": {
       "ApplicationVirtualPath": "/",
       "LocalTempStorageLocation": "Default",
+      "TemporaryFileUploadLocation"
       "Debug": false,
       "SiteName"
     }
@@ -36,6 +37,10 @@ Options:
 * Default
 * EnvironmentTemp
 
+### Temporary file upload location
+
+This setting specifies the location of the temporarily uploaded files, for instance, when uploading files in the media section. The `umbraco/Data/TEMP/TemporaryFile/` folder is used if not specified.
+
 ### Debug
 
 This setting allows you to run Umbraco in debug mode, by setting the value to true.