> ## 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.

# DreamLayer WebUI

> Run persistent local image conversations through the browser interface bundled with DreamLayer.

# DreamLayer WebUI

## What this lets you do

Create and refine images in persistent local conversations. DreamLayer WebUI is the visual interface bundled with the loopback runtime. It is separate from the logged-in developer console.

## What you need

* A running DreamLayer clone
* The loopback URL printed by `./dreamlayer`
* The sample connector, local ComfyUI, or a configured BYOK provider

## Steps

### 1. Create a turn

1. Enter a prompt.
2. Optionally attach one PNG, JPEG, or WebP reference image.
3. Choose an explicit connector or an enabled local orchestrator.
4. Submit and follow the durable job state.

### 2. Continue a conversation

Open a completed result, use it as the next reference, and enter the next instruction. V1 executes one workflow node for each turn.

### 3. Recover after refresh

The browser reloads conversations and canonical jobs from the runtime. A browser refresh does not create a second provider request.

## Confirm it worked

The turn reaches a visible terminal state. A completed turn shows one image, and reopening the conversation preserves its prior turns.

## Common errors

* A reference image is rejected when its format or published size limits are unsupported.
* A connector fails closed when its key, model, or local dependency is unavailable.
* A recovered job can end in a visible failure when safe continuation is impossible.

## Troubleshooting

Provider and DreamLayer keys live in the local server configuration, never browser JavaScript or browser storage.

Run `./dreamlayer doctor --json`, then see [Troubleshooting](/troubleshooting) if a service is not ready.

## Next steps

* [Connect local ComfyUI](/local-comfyui)
* [Configure a BYOK provider](/connectors)
* [Build with an Image Orchestration SDK](/sdks/python)