# Cache settings {% hint style="info" %} This policy is applicable to version 2.0 and above {% endhint %} ## Basics All files, that are read from or written to SharePoint Online via KONNEKT are temporarily cached on the local disc. The cache directory is located at: `%localappdata%\konnekt\cache` This policy defines the caching behavior of KONNEKT. KONNEKT uses the cache for different purposes: * Files that are currently opened by the user * Files that need to be uploaded (write cache) * Files that are closed (read cache) ## **Definitions** ### **Cache TTL (Time To Live)** How long (in minutes) closed documents (read cache) will stay in the Cache. Without this setting, TTL remains automatically at 60 minutes - at "Normal pressure". This value needs to be filled in the input field if the policy is enabled. The cache is always cleared after a restart of KONNEKT. * Dimension: Minutes * Minimum Value: 0 * Maximum Value: * 2880 (KONNEKT releases < 2.6.0) * 60480 (KONNEKT release 2.6.0 or newer) ### **Fixed Cache Size** How big (in Megabytes) is the KONNEKT cache folder. This value needs to be filled in the input field if the policy is enabled. * Dimension: Megabytes * Minimum Value: 0 => cache size will be calculated from free disk space (default) * Maximum Value: 20000 ## **Behind the scenes** ### Pressure states The cache operates in different pressure states: * **Normal pressure:** The cache is utilized below critical values. Closed files will be kept in the read cache up to the TTL value. * **High read pressure:** The cache is filled up with too many closed files. The read cache will be deleted. * **High write pressure:** The cache is holding lots of files queued for upload. Further, write operations will be throttled in order to empty the upload queue. * **Critical write pressure:** The cache is nearly filled up with files queued for upload. Further, write operations will be throttled significantly in order to empty the upload queue. * **Cache full:** The cache is completely occupied. Requests to open further files will be rejected. ### Automatic cache size calculation * **Cache size from free disk calculation**\ *sizeMax* = (*FreeDiskSize* + *CacheSize*) \* 75% * **High pressure calculation**\ *pressure* = *sizeUsed* / *sizeMax* >= 80% * **High write pressure calculation**\ *writePressure* = *uploadSize* / *sizeMax* >= 60% * **Critical write pressure calculation**\ *writePressure* = *uploadSize* / *sizeMax* >= 80% * **Cache filled calculation**\ *sizeUsed* >= *sizeMax* {% hint style="warning" %} To apply the policy you have to **restart the machine** {% endhint %} ## **There are several ways to apply the policy:** * manually by adding the key in the registry under machine or user registry settings * via GPO, [check settings via GPO](https://docs.konnekt.io/configuration/management-options/settings-via-gpo) * pushing policies via Intune, see [setting for Intune Managed Devices](https://docs.konnekt.io/management-options/setting-for-intune-managed-devices-1/intune-system-settings#cache) ![](https://2727108687-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M8zLVuKYctMIUr68_fs%2F-MeijPH0tXKrfoRFnTEl%2F-MeiqtYcZxh6MsREPeNn%2F2021-07-16%2012_27_25-Cache.png?alt=media\&token=727bb9f5-df11-4f0d-829f-9e71e6ac7ea4) #### **Policies** stored in: `HKEY_CURRENT_USER\SOFTWARE\Policies\GlueckKanja\Konnekt` `HKEY_LOCAL_MACHINE\SOFTWARE\Policies\GlueckKanja\Konnekt` {% hint style="warning" %} To apply the policy you have to **restart the machine** {% endhint %} ## Recommendations for VDI environments We recommend the following settings for VDI environments in general, but please make sure, that this setting fit your use-case of KONNEKT: **Cache TTL**: 10-60 min **Cache Size**: 500-1000 MB You may also want to [restrict the file size](https://docs.konnekt.io/configuration/system-settings/open-file-size-limitations), that you are reading from SharePoint Online: **OneDriveOpenFilesLargerThanReadOnly**: 100-500 MB (= 104,857,600 - 524,288,000 bytes) **OneDriveDoNotOpenFilesLargerThan**: 200-1000 MB (= 209,715,200 - 1,048,576,000 bytes) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.konnekt.io/configuration/system-settings/cache-setting.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.