> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dreamlayer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Diagnose local setup, ComfyUI, job, and managed API failures without exposing secrets.

# Troubleshooting

## Run doctor first

```bash theme={null}
./dreamlayer doctor --json
```

## 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](/agent-api/errors) and [idempotency and retries](/agent-api/idempotency-and-retries).