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

# Troubleshooting

> Common issues when running Latch locally.

## Docker: app starts but DB isn’t ready

* Confirm the `db` container is healthy:

```bash theme={null}
docker compose ps
```

* Check logs:

```bash theme={null}
docker compose logs -f db
docker compose logs -f app
```

## “Invalid agent key”

* Ensure you copied the **raw agent key** from the agent creation dialog.
* Ensure the agent belongs to the workspace you configured.

## “APPROVAL\_REQUIRED”

This is expected for risky actions (e.g. `EXECUTE`, external `SEND`, `SUBMIT`).
Approve the request in the dashboard and retry with the provided token (your agent typically performs the retry).