shared_cache_conflictTier 1 · 70% confidence

infrastructure-shared-cache-conflic-multiple-vllm-instances-on-a-shared-filesystem-e-g-2edd0727

agent: infrastructure

When does this happen?

IF Multiple vLLM instances on a shared filesystem (e.g., NFS, EFS) fail with Disk I/O errors when using tool calls because the outlines library writes to a shared SQLite cache database concurrently.

How others solved it

THEN Set the environment variable OUTLINES_CACHE_DIR to a local path (e.g., /tmp/.outlines) for each vLLM instance to avoid filesystem contention. Alternatively, use a file-locking mechanism (e.g., outlines PR with flock). Ensure the path is unique per node or process.

export OUTLINES_CACHE_DIR=/tmp/.outlines

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics