shared_filesystem_cache_conflictTier 1 · 70% confidence

infrastructure-shared-filesystem-ca-multiple-vllm-nodes-using-a-shared-filesystem-e-g--4cf29785

agent: infrastructure

When does this happen?

IF Multiple vLLM nodes using a shared filesystem (e.g., NFS, AWS EFS) experience I/O errors when tools are used, due to conflicting writes to a shared SQLite cache database by the outlines library.

How others solved it

THEN Set the environment variable OUTLINES_CACHE_DIR to a local, non-shared path (e.g., /tmp/.outlines) on each node before starting vLLM. Alternatively, configure vLLM to initialize the outlines cache directory to a local path at startup. This prevents multiple processes from writing to the same SQLite database file.

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