---
outline: deep
---

# DF0045: Instance Registry Update Failed

## Message

> Failed to update the devframe instance registry at "`{file}`": `{reason}`

## Cause

A dev server (or an in-process host calling `registerDevframeInstance`) could not write or remove its record under the instance registry directory — `~/.devframe/instances/` by default, or `$DEVFRAME_INSTANCES_DIR`. Typical causes are a read-only home directory, missing permissions, or a full disk. The server keeps running; only discovery is affected — `devframe connect` will not see this instance.

## Fix

- Check that the registry directory is writable and the disk has free space.
- Point `DEVFRAME_INSTANCES_DIR` at a writable directory.
- Set `DEVFRAME_DISABLE_INSTANCE_REGISTRY=1` to opt out of registration entirely.

## Source

- [`packages/devframe/src/node/instance-registry.ts`](https://github.com/devframes/devframe/blob/main/packages/devframe/src/node/instance-registry.ts) — `registerDevframeInstance()` reports this on a failed write and its `unregister()` on a failed removal.
