---
title: "DF0033: Dev RPC Bridge Failed to Start"
description: "Failed to start dev RPC bridge for \"{id}\": {reason}"
canonical_url: "https://devfra.me/errors/df0033"
---
# DF0033: Dev RPC Bridge Failed to Start

> Failed to start dev RPC bridge for "\{id}": \{reason}

## Message

> Failed to start dev RPC bridge for "`{id}`": `{reason}`

## Cause

`devframeViteBridge()` (from `@devframes/vite`) could not bring up the bridge dev server that pairs a host-served SPA with devframe's RPC backend, usually because the preferred port is taken with no fallback range, or `def.setup(ctx)` threw. The surrounding Vite dev server keeps running, but the SPA's `__connection.json` lookup fails until the bridge starts.

## Fix

- Pin a port via `cli.port` / `cli.portRange` on the definition, or `port` on `devframeViteBridge`.
- Inspect `reason` (or the attached `cause`) to fix the setup function or free the port.

## Source

- [`packages/vite/src/index.ts`](https://github.com/devframes/devframe/blob/main/packages/vite/src/index.ts): `devframeViteBridge()` logs `DF0033` when port resolution or `createDevServer` throws during `configureServer`.


## Sitemap

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