What Does ComfyUI's --reserve-vram Flag Do?

Back
Team Aquanode

Team Aquanode

Ansh Saxena

NOVEMBER 13, 2026

--reserve-vram sets, in gigabytes, how much VRAM ComfyUI leaves free for your operating system and other software. ComfyUI will not plan to use that memory for models.

python main.py --reserve-vram 2

Defaults

Without the flag, the help text says "by default some amount is reserved depending on your OS". In model_management.py that is 400 MB on Linux, and 600 MB on Windows (plus 100 MB more on cards with more than 15 GB of VRAM).

When to change it

  • Other apps share the GPU (a browser, a desktop session, another process) and ComfyUI runs out of memory: raise the value.
  • You want ComfyUI to use more of the card: the value is a float in GB, so a lower value leaves more to ComfyUI, at the risk of crowding out the OS.

The newer dynamic VRAM loader reads the same setting as its headroom. A separate flag, --vram-headroom, sets extra free VRAM above the default for that loader. See what dynamic VRAM is.

For other memory flags see ComfyUI low VRAM mode, and for an error rather than tuning, ComfyUI out of memory.

Sources

  • ComfyUI cli_args.py (--reserve-vram, --vram-headroom). github.com
  • ComfyUI model_management.py (EXTRA_RESERVED_VRAM). github.com
  • ComfyUI main.py (dynamic VRAM init). github.com
#comfyui questions#comfyui vram

ComfyUI on our compute

Rent a GPU with ComfyUI already installed. Your custom nodes and models are there next time. $29 a month, or pay as you go.

Start ComfyUI

Start ComfyUI on a rented GPU.

Sign up in 60 seconds. Pay for the GPU minutes you actually use.

© 2026 Aquanode. All rights reserved.

All trademarks, logos and brand names are the property of their respective owners.