Skip to content

Troubleshooting

Jump to bottom
Dariusz L edited this page Aug 3, 2026 · 1 revision

Troubleshooting

The workflow has no missing models

Check these items:

  1. Confirm that ComfyUI has the workflow loaded in the active graph.
  2. Click Force Rescan in Model Resolver.
  3. Check the model category and the directories configured in ComfyUI.
  4. Clear the frontend and backend cache from Options > Maintenance.
  5. Check whether the model belongs to a custom loader supported by the current adapter.

Model Resolver can only inspect model references present in the workflow data. A custom node that hides its model selection from the workflow may require an adapter update.

Search returns no result

Open the source status row and check the provider message. Then:

  • Enable the source in Options > Download Sources.
  • Check the provider credential if the repository or model requires account access.
  • Select the provider directly instead of Everything.
  • Retry the provider when the status says unavailable or rate_limited.
  • Use the local model list update when the filename should exist in the ComfyUI-Manager database.

Provider outages do not prove that a model is absent. Retry the affected source after it recovers.

Download fails

Check the selected category, root folder, and available disk space. For provider-specific errors, verify the matching credential and accepted terms.

If aria2 fails:

  • Use Options > Download Sources > Check aria2.
  • Leave aria2c path empty when aria2c is available in PATH.
  • Use Install aria2 to install the managed executable.
  • Switch to the Python backend to test the same URL through the built-in downloader.

See Aria2 Download Backend for the full setup guide.

The file downloaded but the workflow still shows it as missing

Wait for the download to reach completed, then refresh the local match list. Check that the file exists below the selected ComfyUI model root and that its category matches the loader. Select the completed local match and click Apply.

Enable Refresh ComfyUI models after Apply when ComfyUI does not expose a newly downloaded file until it refreshes its model catalogs.

Hash matching fails

Hash matching requires the exact local file. A different revision, an incomplete download, or a converted model produces a different SHA-256 value. Calculate the local hash from the model details view and compare the complete value with the provider result.

Bug report details

Export frontend and backend logs from Options > Maintenance. Include:

  • ComfyUI version.
  • Model Resolver version.
  • Operating system.
  • Provider and download backend.
  • The source status or error message.
  • The model category and target path, with tokens and private URLs removed.

Clone this wiki locally