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