docker/cli · error

negative timeout %d is invalid

Error message

negative timeout %d is invalid

What it means

Error "negative timeout %d is invalid" thrown in docker/cli.

Source

Thrown at cli/command/plugin/enable.go:39

			name := args[0]
			if err := runEnable(cmd.Context(), dockerCLI, name, opts); err != nil {
				return err
			}
			_, _ = fmt.Fprintln(dockerCLI.Out(), name)
			return nil
		},
		ValidArgsFunction:     completeNames(dockerCLI, stateDisabled),
		DisableFlagsInUseLine: true,
	}

	flags := cmd.Flags()
	flags.IntVar(&opts.Timeout, "timeout", 30, "HTTP client timeout (in seconds)")
	return cmd
}

func runEnable(ctx context.Context, dockerCli command.Cli, name string, opts client.PluginEnableOptions) error {
	if opts.Timeout < 0 {
		return fmt.Errorf("negative timeout %d is invalid", opts.Timeout)
	}
	_, err := dockerCli.Client().PluginEnable(ctx, name, opts)
	return err
}

View on GitHub (pinned to e9452d6e78)

When it happens

Trigger: Thrown at cli/command/plugin/enable.go:39 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of docker/cli@e9452d6e78 (2026-08-01). Data as JSON: /data/errors/4b8cc94d538ff61c.json. Report an issue: GitHub.