> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rageon.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings: Cache

> Set the cache limit, see what Rageon keeps on disk, and clear it.

Rageon keeps converted models, catalogs, the prepared Map, and AI results on disk so the next opening is faster. The **Cache** tab of **Settings** sets a limit for part of it, shows everything on disk, and clears what you no longer need.

![Settings Cache tab with the total limit, a usage bar, the Persistent index cache switch, and areas grouped under Assets, Map, and AI](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/settings/settings-cache.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=0ad9b4b60fe23266f2b40da5a1604808)

The Cache tab: limit, usage bar, and the areas on disk.

## Set the limit

**1. Open Settings › Cache**

**Total limit in GB** caps the 3D model cache and the indexes together, from 0 to 20 GB. **Combined usage** shows the current use against the limit, and the bar splits it into **3D models** (orange) and **Indexes** (blue).

**2. Change the limit or the index switch**

**Persistent index cache** reuses catalogs already built from the same sources, so the app opens faster. With a limit of 0 the switch is disabled and only this session's indexes are kept.

**3. Click Save**

The footer goes from **Pending** to **Saved**.

## See and clear what is on disk

**On disk** adds up every area below it. Each area shows its size, a button to open its folder, and **Clear**. Expand an area to list its items. **In use** marks what the workspace you have open is using. **Remove** deletes one item.

| Group | Area | What it keeps | What you lose when you clear it |
| - | - | - | - |
| **Assets** | **3D models** | GLBs converted for the viewer and capture. | Models are converted again the next time they open. |
| **Assets** | **Asset and texture indexes** | The catalog of each workspace. | The next time the workspace opens, its catalog is rebuilt, which takes longer. |
| **Map** | **Map library** | Cells, textures, and lighting prepared for each workspace. | The Map has to be prepared again for that workspace, which can take a long time. |
| **Map** | **Map index** | The placement index for each workspace and cell size. | The index is rebuilt the next time the Map opens. |
| **AI** | **AI history** | Candidates returned for each texture. | Removed candidates can no longer be applied from the history. |
| **AI** | **Last AI request** | The images sent in the last request, kept for diagnosis. | Only the diagnostic copy is removed. |

![Map library area expanded with a list of items and an In use badge](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/settings/settings-cache-area.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=32bdf899047149eb91a13b5087ebb73a)

The Map library expanded, with the workspace in use marked.

**1. Click Clear on an area, or Remove on an item**

A confirmation says what you lose.

![Map library confirmation with Cancel and Clear buttons](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/settings/settings-cache-clear-confirm.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=db8e9307072102bf488639fdbe2dc304)

Confirmation before clearing the Map library.

**2. Confirm, or click Cancel**

**Cancel** deletes nothing.

**Clear all** empties every area after one confirmation. An area that is in use is skipped and reported with **Not cleared: …**.

![Clear every cache confirmation with Cancel and Clear all buttons](https://mintcdn.com/rageon/_nzjx4zmIQAxf8Hl/images/settings/settings-cache-clear-all.webp?fit=max\&auto=format\&n=_nzjx4zmIQAxf8Hl\&q=85\&s=2cf6ab95582bfa4345f99d72baaf0d95)

The Clear all confirmation, titled Clear every cache.

> [!WARNING]
>
> **Clear all** also deletes your AI history. Rebuilding the Map library can take a long time, so clear it only when you need the disk space or want it prepared again.

## Troubleshooting

> **Not cleared: …**
>
> The area is in use or could not be removed. Close the Map, wait for any capture or generation to finish, then try again.

> **Cache not updated: …**
>
> Rageon could not save the limit. Try again, or reopen the app.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.