vllm-project/vllm · error · ValueError

standalone-store mode requires global_segment_size == 0

Error message

standalone-store mode requires global_segment_size == 0

What it means

The mirror of error 528: in standalone-store mode all storage lives in the external mooncake store service, so the embedded global segment must be disabled — global_segment_size must be exactly 0. __post_init__ rejects any non-zero value when mode == 'standalone-store'.

Source

Thrown at vllm/distributed/kv_transfer/kv_connector/v1/mooncake/store/worker.py:148

    metadata_server: str
    master_server_address: str
    protocol: str
    device_name: str
    mode: MooncakeMode = "embedded"
    global_segment_size: int = DEFAULT_GLOBAL_SEGMENT_SIZE
    local_buffer_size: int = DEFAULT_LOCAL_BUFFER_SIZE
    enable_offload: bool = False
    tenant_id: str = DEFAULT_TENANT_ID

    def __post_init__(self) -> None:
        if self.mode not in ("embedded", "standalone-store"):
            raise ValueError(f"unknown Mooncake mode: {self.mode!r}")
        if self.local_buffer_size <= 0:
            raise ValueError("local_buffer_size must be > 0")
        if self.mode == "embedded" and self.global_segment_size == 0:
            raise ValueError("embedded mode requires global_segment_size > 0")
        if self.mode == "standalone-store" and self.global_segment_size != 0:
            raise ValueError("standalone-store mode requires global_segment_size == 0")

    @staticmethod
    def from_file(file_path: str) -> "MooncakeStoreConfig":
        with open(file_path) as file:
            config = json.load(file)
        return MooncakeStoreConfig(
            metadata_server=config.get("metadata_server", ""),
            master_server_address=config.get("master_server_address", ""),
            protocol=config.get("protocol", "rdma"),
            device_name=config.get("device_name", ""),
            mode=config.get("mode", "embedded"),
            global_segment_size=_parse_size(
                config.get("global_segment_size", DEFAULT_GLOBAL_SEGMENT_SIZE)
            ),
            local_buffer_size=_parse_size(
                config.get("local_buffer_size", DEFAULT_LOCAL_BUFFER_SIZE)
            ),
            enable_offload=bool(config.get("enable_offload", False)),

View on GitHub (pinned to c794754062)

Solutions

1. Set "global_segment_size": 0 (or "0GB") when using standalone-store mode
2. Or keep the segment and use "mode": "embedded" instead

Example fix

// before
{ "mode": "standalone-store", "global_segment_size": "8GB" }

// after
{ "mode": "standalone-store", "global_segment_size": 0 }

mode, gs = raw.get("mode", "embedded"), _parse_size(raw.get("global_segment_size", DEFAULT))
if mode == "standalone-store" and gs != 0:
    raise ValueError("standalone-store mode needs global_segment_size == 0")

When it happens

Trigger: "mode": "standalone-store" with "global_segment_size": "4GB" (a leftover from an embedded deployment) in the config file.

Common situations: Migrating a node from embedded to standalone-store and editing only the mode; templates that always populate the segment size.

Related errors

• Mooncake preferred_segment override must be a non-empty stri
• unknown Mooncake mode: {self.mode!r}
• local_buffer_size must be > 0
• embedded mode requires global_segment_size > 0
• Unknown dtype: {dtype!r}

AI-assisted analysis of vllm-project/vllm@c794754062 (2026-08-14). Data as JSON: /api/errors/e51ce469d5aea817. Report an issue: GitHub.