tailscale/tailscale · error

unknown arguments

Error message

unknown arguments

What it means

Error "unknown arguments" thrown in tailscale/tailscale.

Source

Thrown at cmd/tailscale/cli/configure-flash-appliance.go:73

partition. On macOS, 'brew install e2fsprogs' provides it.
`),
		FlagSet: (func() *flag.FlagSet {
			fs := newFlagSet("flash-appliance")
			fs.StringVar(&flashApplianceArgs.variant, "variant", "", `appliance variant: "pi-arm64", "vm-amd64", or "vm-arm64". Empty prompts interactively.`)
			fs.StringVar(&flashApplianceArgs.disk, "disk", "", "target block device (e.g. /dev/sdb or /dev/disk4)")
			fs.StringVar(&flashApplianceArgs.track, "track", "", `which track to download from; defaults to "`+clientupdate.CurrentTrack+`"`)
			fs.BoolVar(&flashApplianceArgs.yes, "yes", false, "skip the destructive-write confirmation prompt")
			fs.StringVar(&flashApplianceArgs.gaf, "gaf", "", "use a local GAF file instead of downloading (skips signature verification)")
			fs.StringVar(&flashApplianceArgs.addSSHAuthorizedKeys, "add-ssh-authorized-keys", "", "path to an authorized_keys file to include on the appliance for breakglass SSH access")
			return fs
		})(),
		Exec: runFlashAppliance,
	}
}

func runFlashAppliance(ctx context.Context, args []string) error {
	if len(args) > 0 {
		return errors.New("unknown arguments")
	}
	if runtime.GOOS == "windows" {
		return errors.New("flash-appliance is not supported on Windows yet; consider running under WSL")
	}
	if os.Geteuid() != 0 {
		return errors.New("writing to a raw block device requires root; re-run with sudo")
	}

	disk, err := resolveTargetDisk(ctx, flashApplianceArgs.disk)
	if err != nil {
		return err
	}

	gafPath, gafLabel, variant, cleanup, err := obtainGAF(ctx, gafDownloadArgs{
		localGAF: flashApplianceArgs.gaf,
		track:    flashApplianceArgs.track,
		variant:  flashApplianceArgs.variant,
	})

View on GitHub (pinned to cfe32b8be6)

When it happens

Trigger: Thrown at cmd/tailscale/cli/configure-flash-appliance.go:73 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tailscale/tailscale@cfe32b8be6 (2026-08-15). Data as JSON: /api/errors/af5d08d23ae5d830. Report an issue: GitHub.