# Reference: server.cache

URL: https://scalws.com/docs/reference/server-cache/
Source: `docs/reference/schema` in the ScalWS repository

<h3 id="server.cache.disk"><code>server.cache.disk</code></h3>

| | |
|---|---|
| Syntax | `disk: {...}` |
| Default | `none` |
| Context | `server.cache` |
| Reload | adding or removing it needs a restart; its values apply on reload |

Optional disk tier (ADR-0024).


<h3 id="server.cache.disk.max_entry_size"><code>server.cache.disk.max_entry_size</code></h3>

| | |
|---|---|
| Syntax | `max_entry_size: <size> (e.g. 16KiB)` |
| Default | `none` |
| Context | `server.cache.disk` |
| Reload | needs a restart |

Default: 64 MiB or `size`, whichever is smaller.


<h3 id="server.cache.disk.path"><code>server.cache.disk.path</code></h3>

| | |
|---|---|
| Syntax | `path: <string>` |
| Default | `required` |
| Context | `server.cache.disk` |
| Reload | needs a restart |

Directory of the disk tier; each instance uses its own subdirectory under scalws-controller.


<h3 id="server.cache.disk.size"><code>server.cache.disk.size</code></h3>

| | |
|---|---|
| Syntax | `size: <size> (e.g. 16KiB)` |
| Default | `required` |
| Context | `server.cache.disk` |
| Reload | needs a restart |

Upper bound of the disk tier.


<h3 id="server.cache.max_entry_size"><code>server.cache.max_entry_size</code></h3>

| | |
|---|---|
| Syntax | `max_entry_size: <size> (e.g. 16KiB)` |
| Default | `4MiB` |
| Context | `server.cache` |
| Reload | needs a restart |

Larger responses are not stored in memory (the disk tier may keep them).


<h3 id="server.cache.memory"><code>server.cache.memory</code></h3>

| | |
|---|---|
| Syntax | `memory: <size> (e.g. 16KiB)` |
| Default | `64MiB` |
| Context | `server.cache` |
| Reload | needs a restart |

Total memory for cached responses.
