---
title: "DF0068: Required Service Version Range Not Satisfied"
description: "The installed service \"{package}@{installed}\" does not satisfy the required range \"{required}\"."
canonical_url: "https://devfra.me/errors/df0068"
---
# DF0068: Required Service Version Range Not Satisfied

> The installed service "\{package}@\{installed}" does not satisfy the required range "\{required}".

## Message

> The installed service "`{package}`@`{installed}`" does not satisfy the required range "`{required}`".

## Cause

A service descriptor marked `required: true` declares a `version` range, and the resolved service's own `version` falls outside it. The range is checked when services are constructed before setup. Without `required`, the same mismatch installs the service anyway and warns with [`DF0069`](https://devfra.me/errors/DF0069).

## Example

```ts
defineDevframe({
  services: [
    // ✗ Throws when @devframes/service-shiki@2.x is what's installed.
    { package: '@devframes/service-shiki', version: '^1', required: true },
  ],
})
```

## Fix

Align the installed service package with the declared range (update whichever side is stale), or drop `required: true` to downgrade the mismatch to a warning; the advertised meta carries the real version, so clients can gate on it.

## Source

- [`packages/devframe/src/node/host-services.ts`](https://github.com/devframes/devframe/blob/main/packages/devframe/src/node/host-services.ts): the pre-setup construction checks each descriptor's `version` range against the resolved definition.


## Sitemap

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