---
title: "DF9001: Install Command Failed"
description: "The package manager exited with a non-zero code."
canonical_url: "https://devfra.me/errors/df9001"
---
# DF9001: Install Command Failed

> The package manager exited with a non-zero code.

## Message

> `{command}` exited with code `{exitCode}`.

## Cause

The Install button ran the project's package manager (`npm`, `pnpm`, `yarn`, `bun` or `deno`, detected from the lockfile) and it failed. The last lines of its error output follow the message. Common reasons: no network, a package name that does not exist, or a package manager that is not on `PATH`.

## Fix

Run the command shown in the panel in a terminal to see the full output. Fix the cause, then click Retry. The panel keeps the error until the next attempt.

## Source

- [`packages/hub-ui-onboard/src/install.ts`](https://github.com/devframes/devframe/blob/main/packages/hub-ui-onboard/src/install.ts): `runInstall` throws this when the process exits with a non-zero code. The status route reports it as `{ state: 'error', error: { code, message } }`.


## Sitemap

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