--- title: 'DF0045: Instance Registry Update Failed' description: '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.