Skip to main content

Troubleshooting

Run doctor first

WebUI does not open

Confirm Docker is running, the printed loopback port is available, and the browser is opening the exact URL printed by the launcher.

ComfyUI workflow fails validation

Confirm that the file is API-format JSON, ComfyUI is reachable at the configured loopback URL, and every referenced checkpoint and custom node is installed. DreamLayer does not install or replace them.

A job stopped after refresh

Read canonical job state. Do not submit a new request automatically. Reuse the original caller-owned idempotency key after an uncertain response.

Managed request returns an error

Treat 401, 402, 409, 429, and 5xx differently. See error codes and idempotency and retries.