# manage-runners external-runner install-command

> Print a single-use, 15-minute install command for the agent; running it installs, updates or reinstalls the agent and replaces its credential; --name also needs runners:read

Source: https://managerunners.com/docs/cli/reference/external-runner-install-command/

| | |
| --- | --- |
| Required scopes | `runners:write` |
| Required flags | none |
| Changes state | yes |
| Destructive | no |
| Paid resource effect | none |
| Confirmation | none |
| Non-interactive use | supported |

## Usage

```text
Print a single-use, 15-minute install command for the agent; running it installs, updates or reinstalls the agent and replaces its credential; --name also needs runners:read

Usage:
  manage-runners external-runner install-command [flags]

Flags:
      --id string        external runner id
      --name string      exact external runner name; resolving it needs runners:read
      --profile string   configuration profile
```

Every command also accepts the [global flags](https://managerunners.com/docs/cli/reference/#global-flags). For machine-readable help, run `manage-runners help external-runner install-command --output json`.