---
title: "DF8200: Terminal Session Already Registered"
description: "Terminal session with id \"{id}\" already registered"
canonical_url: "https://devfra.me/errors/df8200"
---
# DF8200: Terminal Session Already Registered

> Terminal session with id "\{id}" 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.


## Sitemap

See the full [sitemap](https://devfra.me/sitemap.md) for all pages.
