Skip to content

Commit 54f168c

Browse files
Add documentation about temporary file location
1 parent d236297 commit 54f168c

File tree

2 files changed

+19
-0
lines changed

2 files changed

+19
-0
lines changed

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

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,3 +47,17 @@ The Umbraco Backoffice uses SignalR for multiple things, including real-time upd
4747
## Background Jobs
4848

4949
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.
50+
51+
## Temporary File Storage
52+
53+
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.
54+
55+
Temporary files are saved to `umbraco/Data/TEMP/TemporaryFile/` by default.
56+
57+
**Azure deployments using scale out:** No additional configuration is required, as the `umbraco` folder is shared between instances.
58+
59+
**Other Environments:** Configure a shared storage location using [the `Umbraco:CMS:Hosting:TemporaryFileUploadLocation` setting.](../../../../reference/configuration/hostingsettings.md#temporary-file-upload-location)
60+
61+
Ensure this path points to a location accessible by all server instances, such as a shared drive or volume.
62+
63+
**Advanced Scenarios:** You can implement a custom `ITemporaryFileRepository` for external storage solutions such as Azure Blob Storage.

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

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ A full configuration with default values can be seen here:
1414
"Hosting": {
1515
"ApplicationVirtualPath": "/",
1616
"LocalTempStorageLocation": "Default",
17+
"TemporaryFileUploadLocation"
1718
"Debug": false,
1819
"SiteName"
1920
}
@@ -36,6 +37,10 @@ Options:
3637
* Default
3738
* EnvironmentTemp
3839

40+
### Temporary file upload location
41+
42+
This setting specifies the location of the temporary uploaded files, for instance when uploading files in the media section. The `umbraco/Data/TEMP/TemporaryFile/` folder is used it not specified.
43+
3944
### Debug
4045

4146
This setting allows you to run Umbraco in debug mode, by setting the value to true.

0 commit comments

Comments
 (0)