# 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**\
  &#x20;*sizeMax* = (*FreeDiskSize* + *CacheSize*) \* 75%
* **High pressure calculation**\
  &#x20;*pressure* = *sizeUsed* / *sizeMax* >= 80%
* **High write pressure calculation**\
  &#x20;*writePressure* = *uploadSize* / *sizeMax* >= 60%
* **Critical write pressure calculation**\
  &#x20;*writePressure* = *uploadSize* / *sizeMax* >= 80%
* **Cache filled calculation**\
  &#x20;*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:&#x20;

**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)