---
outline: deep
---

# DF8200: Terminal Session Already Registered

## Message

> Terminal session with id "`{id}`" already registered

## Cause

`ctx.terminals.register(session)` or `ctx.terminals.startChildProcess(opts, terminal)` was called with an `id` that another session already owns. Terminal ids are unique per hub context.

## Fix

- Pick a different session id (namespace under your tool: `my-tool:build-server`, `my-tool:tests`, …).
- If you want to reuse an existing session's slot, `ctx.terminals.remove(session)` first.

## Source

- [`packages/hub/src/node/host-terminals.ts`](https://github.com/devframes/devframe/blob/main/packages/hub/src/node/host-terminals.ts) — `DevframeTerminalsHost.register()` and `startChildProcess()` throw when the id is already taken.
