paperclipai/paperclip · error · Error

Unsupported bind preset for onboard: ${opts.bind}. Use loopb

Error message

Unsupported bind preset for onboard: ${opts.bind}. Use loopback, lan, or tailnet.

What it means

Error "Unsupported bind preset for onboard: ${opts.bind}. Use loopback, lan, or tailnet." thrown in paperclipai/paperclip.

Source

Thrown at cli/src/commands/onboard.ts:354

export function isEphemeralNpxExecution(entrypoint = process.argv[1]): boolean {
  if (!entrypoint) return false;
  const normalized = entrypoint.replaceAll("\\", "/");
  return normalized.includes("/_npx/") || normalized.includes("/npm/_npx/");
}

function printManagedInstallHint(): void {
  const manifest = readInstallManifest();
  if (manifest && isManagedExecutable(process.argv[1], manifest)) return;
  if (!isEphemeralNpxExecution()) return;
  p.log.info(
    `This npx run is temporary. Use ${pc.cyan("paperclipai install")} for atomic updates, rollback, and service support.`,
  );
}

export async function onboard(opts: OnboardOptions): Promise<void> {
  if (opts.bind && !["loopback", "lan", "tailnet"].includes(opts.bind)) {
    throw new Error(`Unsupported bind preset for onboard: ${opts.bind}. Use loopback, lan, or tailnet.`);
  }

  printPaperclipCliBanner();
  p.intro(pc.bgCyan(pc.black(" paperclipai onboard ")));
  const configPath = resolveConfigPath(opts.config);
  const instance = describeLocalInstancePaths(resolvePaperclipInstanceId());
  p.log.message(
    pc.dim(
      `Local home: ${instance.homeDir} | instance: ${instance.instanceId} | config: ${configPath}`,
    ),
  );

  let existingConfig: PaperclipConfig | null = null;
  let invalidBackupPath: string | undefined;
  if (configExists(opts.config)) {
    p.log.message(pc.dim(`${configPath} exists`));

    try {

View on GitHub (pinned to 67001ec6eb)

When it happens

Trigger: Thrown at cli/src/commands/onboard.ts:354 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@67001ec6eb (2026-08-12). Data as JSON: /api/errors/60666289644b54eb. Report an issue: GitHub.