vllm - 💡(How to fix) Fix [Bug]: Docker Model Runner vLLM ignores tensor parallel config and starts with world_size=1 on 4x RTX 3060 [2 comments, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
vllm-project/vllm#36772Fetched 2026-04-08 00:34:53
View on GitHub
Comments
2
Participants
1
Timeline
3
Reactions
0
Participants
Timeline (top)
commented ×2labeled ×1

Code Example

Your output of `python collect_env.py` here
RAW_BUFFERClick to expand / collapse

Your current environment

<details> <summary>The output of <code>python collect_env.py</code></summary>
Your output of `python collect_env.py` here
</details>

🐛 Describe the bug

Environment

  • Host OS: Ubuntu 22.04
  • GPUs: 4x NVIDIA GeForce RTX 3060 12GB
  • docker model version:
    • Client: v1.1.8
    • Server: v1.1.11
  • docker model status:
    • llama.cpp Running
    • vllm Running (0.17.0)

Model

  • huggingface.co/qwen/qwen3.5-9b
  • Format shown by docker model show: safetensors
  • Size: 19.31GB

What I expected

Since this is a safetensors model and Docker Model Runner routes safetensors models to vLLM, I expected the model to be served with tensor parallelism across 4 GPUs when configured accordingly.

What actually happened

The model is routed to vLLM, but the engine core starts with:

  • tensor_parallel_size=1
  • pipeline_parallel_size=1
  • data_parallel_size=1
  • world_size=1

As a result, the model loads only on GPU 0 and fails with CUDA OOM, instead of sharding across 4 GPUs.

Steps to reproduce

  1. Install the runner with vLLM + CUDA:
    docker model stop-runner
    docker model uninstall-runner --images
    docker model install-runner --backend vllm --gpu cuda
    docker model status

Before submitting a new issue...

  • Make sure you already searched for relevant issues, and asked the chatbot living at the bottom right corner of the documentation page, which can answer lots of frequently asked questions.

extent analysis

Fix Plan

To fix the issue, you need to configure the Docker Model Runner to use tensor parallelism across 4 GPUs.

  • Stop the runner: docker model stop-runner
  • Uninstall the runner: docker model uninstall-runner --images
  • Install the runner with vLLM + CUDA and specify the number of GPUs:
    docker model install-runner --backend vllm --gpu cuda --num-gpus 4
  • Update the model configuration to use tensor parallelism:
    import torch
    
    # Set the device (4 GPUs)
    device = torch.device("cuda:0" if torch.cuda.is_available() else "cpu")
    torch.cuda.set_device(device)
    
    # Set the tensor parallel size
    tensor_parallel_size = 4
    
    # Load the model with tensor parallelism
    from transformers import AutoModel
    model = AutoModel.from_pretrained("huggingface.co/qwen/qwen3.5-9b", 
                                      device_map={0: [0, 1, 2, 3]})  # Map the model to 4 GPUs

Verification

To verify that the fix worked, check the model configuration and GPU usage:

  • Check the model configuration: docker model show
  • Check the GPU usage: nvidia-smi

Extra Tips

  • Make sure you have the latest version of the Docker Model Runner and vLLM installed.
  • Check the documentation for the docker model install-runner command for more options and configuration parameters.
  • You can also use the --data-parallel-size and --pipeline-parallel-size options to configure the data parallelism and pipeline parallelism.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

vllm - 💡(How to fix) Fix [Bug]: Docker Model Runner vLLM ignores tensor parallel config and starts with world_size=1 on 4x RTX 3060 [2 comments, 1 participants]