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

# Clone and run

> Install the complete open-source system from its repository.

# Clone and run

## What this lets you do

Install the open-source image infrastructure and keep conversations, jobs, assets, and provider keys on your machine.

## What you need

* Git
* Python 3.11 or later
* `uv`
* Node.js 22.12 or later
* `pnpm` 10
* A current browser

## Steps

### 1. Start the runtime

```bash theme={null}
git clone https://github.com/TheDesignFounder/dreamlayer-runtime
cd dreamlayer-runtime
./dreamlayer
```

The first release is clone-and-run. PyPI and npm publication are separate release actions and are not required for the beta.

### 2. Stop and resume

Press `Ctrl+C` in the terminal that runs DreamLayer. Start it again with `./dreamlayer`.

Conversations and durable job state remain in the local data directory. A job interrupted by a runtime restart is recovered or moved to a visible terminal failure state.

## Confirm it worked

The launcher prints a loopback URL, DreamLayer WebUI opens there, and a sample job reaches a visible terminal state.

## Common errors

* If `uv`, Node.js, or `pnpm` is missing, install the prerequisite and repeat step 1.
* If the browser cannot connect, use the exact loopback URL printed by the launcher.
* If startup fails after an upgrade, run `./dreamlayer doctor --json` and keep the sanitized output.

## Troubleshooting

The runtime binds to loopback, validates Host and Origin, and gives the browser a local session. Provider keys stay in the local server process. Do not weaken these controls to work around a setup problem. See [Troubleshooting](/troubleshooting).

## Next steps

* [Create an image in DreamLayer WebUI](/webui)
* [Connect local ComfyUI](/local-comfyui)
* [Configure a BYOK provider](/connectors)

The runtime binds to loopback, validates Host and Origin, and gives the browser a local session. Provider keys stay in the local server process.