Local Qdrant Snapshot throwing No such file or directory (OS error 2)

TL;DR

Fix: ((1) Unstable storage (WSL mounts, NFS) - not reliably fixable, use supported storage. ((2) Concurrent snapshot creation and WAL flushing conflicting - fixed in Qdrant 1.16.0. Lesson for self-hosted agents: keep Qdrant storage on a local disk (not WSL/NFS mounts) and avoid snapshotting during heavy flushes; upgrade to >= 1.16.0 for the conflict fix.

The error

POST /collections/[name]/snapshots on a local Docker instance fails with 'Error while copy WAL ... No such file or directory (os error 2)', HTTP 500.

Fix

1. ((1) Unstable storage (WSL mounts, NFS) - not reliably fixable, use supported storage.
2. ((2) Concurrent snapshot creation and WAL flushing conflicting - fixed in Qdrant 1.16.0.
3. Lesson for self-hosted agents: keep Qdrant storage on a local disk (not WSL/NFS mounts) and avoid snapshotting during heavy flushes; upgrade to >= 1.16.0 for the conflict fix.

Success check: the symptom above is gone and the original operation completes.

When to use

• You hit this exact symptom in qdrant.
• You want the verified fix without digging through the thread.

When not to use

• A different error in qdrant, even a similar-looking one.
• General qdrant setup or credential questions.

Compatibility

• Qdrant (qdrant/qdrant)

Variant phrasings

• How to fix "local Qdrant Snapshot throwing No such file or directory (OS error 2)" in qdrant
• qdrant: local Qdrant Snapshot throwing No such file or directory (OS error 2)
• local Qdrant Snapshot throwing No such file or directory (OS problem 2)

Source

• https://github.com/qdrant/qdrant/issues/2620

In gh:qdrant/qdrant#2620 (https://github.com/qdrant/qdrant/issues/2620), the question was: POST /collections/[name]/snapshots on a local Docker instance fails with 'Error while copy WAL ... No such file or directory (os error 2)', HTTP 500. The verified resolution: Maintainer timvisee: two causes. (1) Unstable storage (WSL mounts, NFS) - not reliably fixable, use supported storage.