---
title: "DF0045: Instance Registry Update Failed"
description: "Failed to update the devframe instance registry at \"{file}\": {reason}"
canonical_url: "https://devfra.me/errors/df0045"
---
# DF0045: Instance Registry Update Failed

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

## Message

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

## Cause

A dev server (or a host calling `registerDevframeInstance`) could not write or remove its record in the instance registry directory (`~/.devframe/instances/` by default, or `$DEVFRAME_INSTANCES_DIR`), usually a read-only home, missing permissions, or a full disk. The server keeps running; only discovery is affected, so `devframe connect` won't 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.


## Sitemap

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