# Configure an external in-memory cache

{% hint style="info" %}
**Valkey replaces Redis as of CARTO Self-Hosted 2026.04.** [Valkey](https://valkey.io/) is an open-source fork of Redis 7.2 and is fully wire-compatible: existing external Redis instances continue to work as a drop-in cache without configuration changes. For versions earlier than 2026.04, see the [legacy documentation](/carto-self-hosted/carto-self-hosted-legacy.md).
{% endhint %}

CARTO Self-Hosted requires Valkey (version 6 or above) to work. This Valkey instance does not need persistence, as it is used solely as a cache.

Both [**Single VM deployment**](/carto-self-hosted/overview.md#single-vm-deployment-docker-compose) and [**Orchestrated container deployment**](/carto-self-hosted/overview.md#orchestrated-container-deployment-kubernetes) come already with an internal Valkey deployment, but they lack any backups, autoscaling, or monitoring. Cloud vendors already offer Valkey deployments at scale as a service:

* [Google Memorystore for Redis](https://cloud.google.com/memorystore).
* [Amazon ElastiCache for Redis](https://aws.amazon.com/elasticache/redis/).
* [Azure Cache for Redis](https://azure.microsoft.com/en-us/products/cache).

## Configuration

In this section, you will see how to configure the Self-hosted to use an external Valkey provided by your cloud vendor. The needed changes can be applied from the Admin Console, as you'll have to update the following config:

<figure><img src="/files/lsXj39YuK0ZWaeSSSWLR" alt=""><figcaption></figcaption></figure>

### Configure TLS

By default, CARTO will try to connect to your Valkey without TLS enabled. In case you want to connect via TLS, you can enable it and configure your SSL certificate if it's a selfsigned one or it's signed by a custom CA.


---

# 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.carto.com/carto-self-hosted/guides/guides/configure-an-external-in-memory-cache.md?ask=<question>
```

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.
