> For the complete documentation index, see [llms.txt](https://cfconfig.ortusbooks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cfconfig.ortusbooks.com/using-the-cli/command-overview/manage-caches.md). # Manage Caches There are three commands to manage Lucee/Railo caches. ## List existing caches ```bash # Lucee server context of the CommandBox server in the current directory cfconfig cache list # Lucee web context of the CommandBox server in the current directory cfconfig cache list fromFormat=luceeWeb # Target a CommandBox server by name cfconfig cache list from=serverName # Target an externally installed server cfconfig cache list from=/path/to/server/home ``` To receive the data back as JSON, use the `--JSON` flag. ``` cfconfig cache list --JSON ``` ## Edit an existing or create a new cache Add a new cache or update an existing cache. Existing caches will be matched based on the name. You can use a the `type` parameter as a shortcut for specifying the full Java class, which may change between versions. ``` cfconfig cache save myCache RAM cfconfig cache save name=myOtherCache type=EHCache cfconfig cache save name=myCache type=EHCache to=serverName cfconfig cache save name=myCache type=RAM to=/path/to/server/home ``` Alternatively, specify the full class name. ``` cfconfig cache save myCache lucee.runtime.cache.ram.RamCache cfconfig cache save name=myCache class=lucee.runtime.cache.ram.RamCache to=serverName cfconfig cache save name=myCache class=lucee.runtime.cache.ram.RamCache to=/path/to/server/home ``` If your cache provider expects custom properties, pass them as additional parameters to this command prefixed with the text `custom:`. This requires named parameters, of course. ``` cfconfig cache save name=myCache type=RAM custom:timeToIdleSeconds=0 custom:timeToLiveSeconds=0 ``` ## Delete an existing cache Identify the cache uniquely by the name. ``` cfconfig cache delete myCache cfconfig cache delete myCache serverName cfconfig cache delete myCache /path/to/server/home ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://cfconfig.ortusbooks.com/using-the-cli/command-overview/manage-caches.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.