paperclipai/paperclip · error

Requested port is busy; using next free port (requestedPort=

Error message

Requested port is busy; using next free port (requestedPort=${requestedListenPort}, selectedPort=${listenPort})

What it means

Startup warning in startServer's HTTP listener setup. Fires when the requested listen port (requestedListenPort) is already bound, so the server falls back to the next free port and logs both ports; dev/demo convenience, not an error.

Source

Thrown at server/src/index.ts:894

    uiMode,
    serverPort: listenPort,
    storageService,
    feedbackExportService: feedback,
    databaseBackupService: {
      runManualBackup: async () => {
        const result = await runServerDatabaseBackup("manual");
        if (!result) {
          throw conflict("Database backup already in progress");
        }
        return result;
      },
    },
    databaseBackupHealth: config.databaseBackupEnabled
      ? {
          enabled: config.databaseBackupEnabled,
          backupDir: config.databaseBackupDir,
          maxAgeHours: databaseBackupMaxAgeHours,
          alertFile: databaseBackupAlertFile,
          alertFiles: databaseBackupAlertFiles,
        }
      : undefined,
    deploymentMode: config.deploymentMode,
    deploymentExposure: config.deploymentExposure,
    allowedHostnames: config.allowedHostnames,
    bindHost: config.host,
    authPublicBaseUrl: config.authPublicBaseUrl,
    authReady,
    companyDeletionEnabled: config.companyDeletionEnabled,
    pluginMigrationDb: pluginMigrationDb as any,
    betterAuthHandler,
    resolveSession,
    pluginWorkerManager,
    decisionServiceOptions,
    managedPluginAutoInstall,
  });
  const server = createServer(app as unknown as Parameters<typeof createServer>[0]);

View on GitHub (pinned to 01ad858492)

Solutions

1. No action needed; the server bound to the next free port.
2. To use the requested port, stop the process occupying it or configure a different listen port.

When it happens

Trigger: Thrown at server/src/index.ts:775 when the library encounters an invalid state.

Common situations: Logged at startup when the requested listen port is busy and the server automatically selects the next available port.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-08-18). Data as JSON: /api/errors/94c1520109a99147. Report an issue: GitHub.