juanfont/headscale · error

deleting node: %w

Error message

deleting node: %w

What it means

Error "deleting node: %w" thrown in juanfont/headscale.

Source

Thrown at cmd/headscale/cli/nodes.go:287

		getResponse, err := client.GetNodeWithResponse(ctx, nodeID)
		if err != nil {
			return fmt.Errorf("getting node: %w", err)
		}

		if getResponse.StatusCode() != http.StatusOK {
			return apiError(getResponse.StatusCode(), getResponse.ApplicationproblemJSONDefault)
		}

		if !confirmAction(cmd, fmt.Sprintf(
			"Do you want to remove the node %s?",
			getResponse.JSON200.Node.Name,
		)) {
			return printOutput(cmd, map[string]string{colResult: "Node not deleted"}, "Node not deleted")
		}

		deleteResponse, err := client.DeleteNodeWithResponse(ctx, nodeID)
		if err != nil {
			return fmt.Errorf("deleting node: %w", err)
		}

		if deleteResponse.StatusCode() != http.StatusOK {
			return apiError(deleteResponse.StatusCode(), deleteResponse.ApplicationproblemJSONDefault)
		}

		return printOutput(
			cmd,
			map[string]string{colResult: "Node deleted"},
			"Node deleted",
		)
	}),
}

var backfillNodeIPsCmd = &cobra.Command{
	Use:   "backfillips",
	Short: "Backfill IPs missing from nodes",
	Long: `

View on GitHub (pinned to 565fd254d0)

Solutions

  1. Inspect the wrapped error for the underlying cause and correct the failing condition (deleting node); retry the operation after fixing the input, configuration, or environment.

Example fix

Inspect the wrapped error for the underlying cause and correct the failing condition (deleting node); retry the operation after fixing the input, configuration, or environment.

When it happens

Trigger: Thrown at cmd/headscale/cli/nodes.go:287 when the library encounters an invalid state.

Common situations: Deleting the node failed. Verify the node exists and the CLI has a valid connection and credentials to the server.


AI-assisted analysis of juanfont/headscale@565fd254d0 (2026-08-15). Data as JSON: /api/errors/ce16e0470b40f0e0. Report an issue: GitHub.