Back up before updating ComfyUI: a source rollback is not an environment rollback

Purpose and scope

Recovering old code does not automatically restore Python packages, frontend, nodes or configuration. Establish recovery information for the whole relevant environment.

Source-supported context

Official update guidance separates installation methods and related requirements. pip check may reveal conflicts but cannot restore prior artifacts or guarantee binary compatibility. Source 1 Source 2 Source 3

Before you start

1. Back up user workflows, settings, extra model paths and outputs that must be retained.

2. Record core, frontend, templates, custom nodes, Python/Torch and installation type.

3. Distinguish redownloadable models from unique user data to avoid unnecessary copies of huge weights.

Steps and checks

The sequence below is an editorial procedure based on the cited context, not a diagnosis already confirmed for your environment.

Step 1. Run a known small workflow before updating and preserve input, result and environment as a baseline.

Step 2. Prefer updating a copy or new environment, reading release notes without introducing many new extensions simultaneously.

Step 3. Check startup, registration, model loading and the baseline in order. Compare the actual change when failure occurs rather than continuing to upgrade until the error changes.

Step 4. Restore code, packages, frontend and nodes coherently and verify the restored process path against the original baseline.

Commands and request examples

Use the environment and shell identified above. Paths and variables are examples to adapt; these commands/snippets were not executed for your machine. The freeze command writes a local snapshot; inspect it for private repository URLs before sharing.

python -m pip freeze > environment-before-update.txt
python -m pip check

Completion check

The change, baseline result and recovery procedure are explicit. Restored page rendering alone is not proof that workflows remain compatible.

Limitations and cautions

Do not run destructive Git resets, delete environments or overwrite user directories without confirmation. pip freeze records versions but does not guarantee future availability of matching artifacts; inspect snapshots for private URLs/paths before sharing.

Original sources

• How to update ComfyUI — original record checked 2026-09-21.
• ComfyUI custom node troubleshooting — original record checked 2026-09-21.
• pip check — original record checked 2026-09-21.

Localization prepared: 2026-09-22. The source-check dates above were inherited from the existing article; this translation does not claim they were all rechecked today. No GPU run, minimum-memory measurement or runtime guarantee is supplied.

Related troubleshooting and guides

• Core updated but nodes or templates are missing: check component versions separately
• Cannot import name after an update: check the importing code and dependency together
• NumPy ABI errors: _ARRAY_API and dtype size changed