nektos/act · error

exitcode '%d': command not found, please refer to https://gi

Error message

exitcode '%d': command not found, please refer to https://github.com/nektos/act/issues/107 for more information

What it means

Error "exitcode '%d': command not found, please refer to https://github.com/nektos/act/issues/107 for more information" thrown in nektos/act.

Source

Thrown at pkg/container/docker_run.go:616

switch inspectResp.ExitCode {
case 0:
	return nil
case 127:
	return fmt.Errorf("exitcode '%d': command not found, please refer to https://github.com/nektos/act/issues/107 for more information", inspectResp.ExitCode)
default:
	return fmt.Errorf("exitcode '%d': failure", inspectResp.ExitCode)
}

View on GitHub (pinned to 4f41128141)

Solutions

1. Install the missing tool in the runner image or use an image that contains it (see https://github.com/nektos/act/issues/107).
2. Use the full path to the command in the step's run/args.
3. Add a step that installs the required tool before it is used.

When it happens

Trigger: Thrown at pkg/container/docker_run.go:616 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of nektos/act@4f41128141 (2026-08-15). Data as JSON: /api/errors/71e28ecb20add2c9. Report an issue: GitHub.