---
title: "DF9004: Onboarding State File Unreadable"
description: "The onboarding state file could not be read or written."
canonical_url: "https://devfra.me/errors/df9004"
---
# DF9004: Onboarding State File Unreadable

> The onboarding state file could not be read or written.

## Message

> The onboarding state file `{file}` could not be read or written.

## Cause

`createOnboarding()` reads `<stateDir>/hub-ui-onboard.json` at start to learn whether the user disabled DevTools, and the Disable button writes it. The file exists but is not valid JSON, or the directory is not writable.

## Fix

Delete the file if it is corrupt. If the directory is read-only, pass another `stateDir`. The default is `<cwd>/node_modules/.devframe`.

## Source

- [`packages/hub-ui-onboard/src/index.ts`](https://github.com/devframes/devframe/blob/main/packages/hub-ui-onboard/src/index.ts): `readDisabled` warns and treats the state as not disabled; `disable()` answers the request with status 500 and this code.


## Sitemap

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