fix(docs): add valid cache keys to Redis docs and Apple Silicon warning to Docker page (#541)

Fixes #428: The Redis configuration doc previously listed STATIC_CONFIG as
a valid cache key, which was deprecated and causes startup errors. Added a
complete table of valid CacheKeys values with descriptions, plus a callout
warning about invalid keys.

Fixes #228: The Docker installation page had no mention of the AVX
incompatibility with Apple Silicon (M-series) Macs. Added a prominent
callout in the Prerequisites section with the docker-compose.override.yml
fix to use mongo:4.4.18.
This commit is contained in:
Marco Beretta
2026-03-22 03:31:46 +01:00
committed by GitHub
parent 00586da525
commit 4174c8dd6c
2 changed files with 46 additions and 1 deletions

View File

@@ -13,6 +13,22 @@ For most scenarios, Docker Compose is the recommended installation method due to
Docker Desktop is recommended for most users. For remote server installations, see the [Ubuntu Docker Deployment Guide](/docs/remote/docker_linux).
<Callout type="warn" title="Apple Silicon (M-series) Macs">
Mac computers with Apple Silicon (M1, M2, M3, M4) processors do not support AVX instructions, which are required by the default MongoDB image used in LibreChat's Docker Compose setup. If you're on an M-series Mac, MongoDB will crash on startup.
**Fix:** Create a `docker-compose.override.yml` to use an older, compatible MongoDB image:
```yaml filename="docker-compose.override.yml"
services:
mongodb:
image: mongo:4.4.18
```
See the [Docker Override guide](/docs/configuration/docker_override) for more details.
</Callout>
## Installation
<Steps>