Skip to main content
The vllm collect-env command collects detailed information about your environment, which is useful for debugging and reporting issues.

​
Usage

vllm collect-env

​
What it collects

The command gathers information about:
  • vLLM version - Installed vLLM version and commit hash
  • Python version - Python interpreter version
  • PyTorch version - PyTorch and CUDA versions
  • GPU information - NVIDIA/AMD GPU model, driver version, CUDA/ROCm version
  • CPU information - CPU model and architecture
  • Operating system - OS type and version
  • Environment variables - Relevant vLLM environment variables
  • Dependencies - Key dependency versions (transformers, xformers, flash-attn, etc.)

​
Example output

$ vllm collect-env

Collecting environment information...
vLLM version: 0.6.0
vLLM commit: abc123def456
Python version: 3.11.7
PyTorch version: 2.10.0+cu126
CUDA version: 12.6
GPU: NVIDIA A100-SXM4-80GB
Driver version: 535.129.03
OS: Linux-5.15.0-1052-aws
CPU: x86_64 (Intel(R) Xeon(R) Platinum 8375C CPU @ 2.90GHz)
Transformers version: 4.45.0
Flash Attention: 2.7.0
xFormers: 0.0.28

​
When to use

Use vllm collect-env when:

Reporting issues

Include this output when filing GitHub issues

Debugging

Verify your environment setup and dependencies

Version checking

Quickly check installed versions of vLLM and dependencies

Support requests

Provide environment details when asking for help

​
Common issues detected

The command can help identify:
  • CUDA/driver mismatch - Incompatible CUDA and driver versions
  • Missing dependencies - Required packages not installed
  • Wrong Python version - Python version outside supported range (3.10-3.13)
  • GPU not detected - GPU hardware or driver issues
Always run vllm collect-env before reporting issues on GitHub. Including this information helps maintainers diagnose problems faster.

​
Saving output to file

# Save to file for issue reporting
vllm collect-env > environment.txt

# Include in GitHub issue
cat environment.txt

Build docs developers (and LLMs) love

Get started for freeTalk to us