litellm/litellm/proxy/example_config_yaml
Yassin Kortam 3ea7f98725
feat(proxy): configure the coordination redis independently of the response cache (#32661)
* fix(proxy): build redis usage cache from REDIS_* env when cache backend is not Redis

Selecting a semantic (or any non-Redis-KV) response cache left
redis_usage_cache unset, silently downgrading cross-pod rate limits,
parallel-request limits, spend coordination, and the pod lock manager
to per-pod in-memory state. Fall back to a standalone RedisCache built
from REDIS_* environment variables, mirroring the existing
use_redis_transaction_buffer escape hatch, which now shares the same
helper.

Resolves LIT-3861

* feat(proxy): configure the coordination redis independently of the response cache

Adds general_settings.coordination_redis, an explicit block for the Redis
the proxy uses for cross-pod rate limits, parallel-request limits, spend
tracking, the pod lock manager, and shared health checks. Resolution order
is the explicit block, then a plain-Redis response-cache backend, then the
REDIS_* environment. Cluster and sentinel targets are supported, and a
cluster target now builds a RedisClusterCache so cluster-aware consumers
take the cluster path.

Admins can configure it from the Caching page of the dashboard via
/coordination_redis/settings, which reports which source is in effect,
redacts credentials on read, and offers a connection test. Settings saved
there are read back at startup so they take effect on restart.

Also fixes redis client construction so an explicitly configured host
outranks REDIS_URL in the environment. Previously the url branch stripped
the caller's host and port, so an explicit block, or a connection test
typed into the dashboard, silently targeted whatever REDIS_URL named

* fix(ui): move coordination_redis_settings into renamed _components directory

---------

Co-authored-by: Yucheng Zhu <yucheng@berri.ai>
2026-07-10 16:15:59 -07:00
..
_health_check_test_config.yaml feat(utils.py): support google kms for secret management 2023-12-26 15:39:40 +05:30
adaptive_router_example.yaml fix(adaptive_router): 3 P1 review defects 2026-04-20 15:22:18 -07:00
aliases_config.yaml (chore) fix config yaml 2023-11-15 17:12:28 -08:00
azure_config.yaml (docs) add example config.yaml 2023-12-04 18:08:57 -08:00
bad_schema.prisma Litellm expose disable schema update flag (#6085) 2024-10-05 21:26:51 -04:00
code_interpreter_interception_config.yaml feat(sandbox): code interpreter interceptor on the Responses API (#30905) 2026-06-20 21:12:13 -07:00
custom_auth.py fix user_api_key_auth example config 2025-03-26 08:36:11 -07:00
custom_auth_basic.py [Infra] Merging RC Branch with Main (#23786) 2026-03-16 15:32:20 -07:00
custom_callbacks.py style: unify ruff format width on 120 (#31518) 2026-06-27 12:39:29 -07:00
custom_callbacks1.py style: unify ruff format width on 120 (#31518) 2026-06-27 12:39:29 -07:00
custom_guardrail.py style: unify ruff format width on 120 (#31518) 2026-06-27 12:39:29 -07:00
custom_handler.py Litellm remove circular imports (#7232) 2024-12-14 16:28:34 -08:00
disable_schema_update.yaml ci: run a local fake OpenAI endpoint instead of the shared Railway mock (#30695) 2026-06-17 17:01:13 -07:00
enterprise_config.yaml ci: run a local fake OpenAI endpoint instead of the shared Railway mock (#30695) 2026-06-17 17:01:13 -07:00
langfuse_config.yaml (docs) add example configs to proxy 2023-11-15 16:41:26 -08:00
load_balancer.yaml (docs) load balancer 2023-11-17 17:25:46 -08:00
multi_instance_simple_config.yaml feat(proxy): configure the coordination redis independently of the response cache (#32661) 2026-07-10 16:15:59 -07:00
oai_misc_config.yaml Revert "chore(tests): migrate Bedrock CI to AWS account 941277531214 (#28728)" (#29326) 2026-05-30 11:26:24 -07:00
opentelemetry_config.yaml (docs) proxy: add example OTEL config yaml 2023-12-02 11:22:40 -08:00
otel_test_config.yaml ci: run a local fake OpenAI endpoint instead of the shared Railway mock (#30695) 2026-06-17 17:01:13 -07:00
pass_through_config.yaml chore(ci): modernize model references in tests and configs (#27856) 2026-05-15 15:44:28 -07:00
pipeline_test_guardrails.py [Guardrails] Add guardrail pipeline support for conditional sequential execution (#21177) 2026-02-13 19:49:12 -08:00
reject_clientside_metadata_tags_config.yaml Add enforce user param functionality (#17088) 2025-11-25 09:36:24 -08:00
simple_config.yaml chore(ci): modernize model references in tests and configs (#27856) 2026-05-15 15:44:28 -07:00
spend_tracking_config.yaml feat(proxy): configure the coordination redis independently of the response cache (#32661) 2026-07-10 16:15:59 -07:00
store_model_db_config.yaml ci: run a local fake OpenAI endpoint instead of the shared Railway mock (#30695) 2026-06-17 17:01:13 -07:00
test_pipeline_config.yaml [Guardrails] Add guardrail pipeline support for conditional sequential execution (#21177) 2026-02-13 19:49:12 -08:00
tool_permission_example.yaml feat: allow custom violation message for tool-permission guardrail (#16916) 2025-11-21 08:52:01 -08:00
websearch_interception_config.yaml Litellm oss staging 050626 (#29774) 2026-06-05 13:51:51 -07:00