paperclipai/paperclip · error · Error

server.bind=tailnet requires a detected Tailscale address or

Error message

server.bind=tailnet requires a detected Tailscale address or PAPERCLIP_TAILNET_BIND_HOST

What it means

Bind-resolution error surfaced by resolveRuntimeBind inside loadConfig: server.bind=tailnet was requested, but no Tailscale address could be detected on this host and PAPERCLIP_TAILNET_BIND_HOST is unset. The tailnet bind target is indeterminate, so startup stops.

Source

Thrown at server/src/config.ts:306

    workspaceReaperCooldownDaysEnv
      && Number.isFinite(workspaceReaperCooldownDaysRaw)
      && workspaceReaperCooldownDaysRaw >= 0
      ? workspaceReaperCooldownDaysRaw
      : 7;
  const bindValidationErrors = validateConfiguredBindMode({
    deploymentMode,
    deploymentExposure,
    bind,
    host: configuredHost,
    customBindHost,
  });
  if (bindValidationErrors.length > 0) {
    throw new Error(bindValidationErrors[0]);
  }
  const resolvedBind = resolveRuntimeBind({
    bind,
    host: configuredHost,
    customBindHost,
    tailnetBindHost,
  });
  if (resolvedBind.errors.length > 0) {
    throw new Error(resolvedBind.errors[0]);
  }

  return {
    deploymentMode,
    deploymentExposure,
    bind: resolvedBind.bind,
    customBindHost: resolvedBind.customBindHost,
    host: resolvedBind.host,
    port: Number(process.env.PORT) || fileConfig?.server.port || 3100,
    allowedHostnames,
    authBaseUrlMode,
    authPublicBaseUrl,
    authDisableSignUp,
    databaseMode: fileDatabaseMode,

View on GitHub (pinned to 01ad858492)

Solutions

1. Set PAPERCLIP_TAILNET_BIND_HOST to the machine's Tailscale address.
2. Ensure Tailscale is running so the address can be detected, or use a different server.bind mode.

When it happens

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

Common situations: See trigger scenarios.

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