usebruno/bruno · error · Error

Mock server id is required.

Error message

Mock server id is required.

What it means

Error "Mock server id is required." thrown in usebruno/bruno.

Source

Thrown at packages/bruno-electron/src/app/mock-server/mock-server.js:508

const start = async ({
  mockServerUid,
  serverName,
  sourceType = 'collection',
  collectionPath,
  collectionName,
  brunoConfig,
  specPath,
  workspacePath,
  port = DEFAULT_GATEWAY_PORT,
  globalDelay = 0
}) => {
  if (!preferencesUtil.isBetaFeatureEnabled('mock-server')) {
    throw new Error('Mock server is a beta feature. Enable it in Preferences > Beta.');
  }

  if (!mockServerUid) {
    throw new Error('Mock server id is required.');
  }

  if (collections.has(mockServerUid)) {
    await stop(mockServerUid);
  }

  const routeMap = buildRouteMapFromMockResponses({
    mockServerUid,
    sourceType,
    collectionPath,
    workspacePath
  });

  let resolvedPort = Number(port) || DEFAULT_GATEWAY_PORT;
  resolvedPort = await resolveIsolatedPort(resolvedPort, mockServerUid);

  const app = express();
  applyMockMiddleware(app);

View on GitHub (pinned to 9bdd81c7bd)

Solutions

1. Select an existing mock server before running this operation.
2. Create a mock server first, then retry.

When it happens

Trigger: Thrown at packages/bruno-electron/src/app/mock-server/mock-server.js:508 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of usebruno/bruno@9bdd81c7bd (2026-08-13). Data as JSON: /api/errors/94d0c1d7436ee89e. Report an issue: GitHub.