---
outline: deep
---

# DF8102: Dock Not Registered

## Message

> Dock with id "`{id}`" is not registered and cannot be updated

## Cause

`ctx.docks.update(view)` was called with an `id` that has no prior registration. `update` is for mutating existing entries; new entries must go through `register`.

## Fix

- Use `ctx.docks.register(view)` for new entries.
- Verify the id matches a previously registered dock — typos / case mismatches are the usual cause.

## Source

- [`packages/hub/src/node/host-docks.ts`](https://github.com/devframes/devframe/blob/main/packages/hub/src/node/host-docks.ts) — `DevframeDocksHost.update()` throws when `views.has(view.id) === false`.
