> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nuon.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Runner Management Mode

> Configure runner management mode for new installs or migrate existing installs.

## What is Management Mode?

Runner management mode is a standalone process that is deployed *first* in an
install's runner VM. Once it has started, it is responsible for configuring,
starting, monitoring, and updating a child runner process for the install
itself. This install runner process then carries out all of the day to day
runner operations. This allows for an additional degree of flexibility when
managing updates and paves the way for future runner features.

This release introduces runner management mode into GA as an opt-in feature
which can be enabled by configuring the `init_script_url` attribute in
`runner.toml` in the app. We recommend all new installs make use of it from
day-1.

## Migrating an existing Install

1. Update `runner.toml` to use the management mode init script.

```toml runner.toml theme={null}
init_script_url = "https://raw.githubusercontent.com/nuonco/runner/refs/heads/main/scripts/aws/init-mng.sh"
```

2. Update `stack.toml` to use the 1.6 version of the Runner ASG nested CF stack
   `runner_nested_template_url`.

```toml stack.toml theme={null}
runner_nested_template_url = "https://nuon-artifacts.s3.us-west-2.amazonaws.com/aws-cloudformation-templates/v0.1.6/runner/asg/stack.yaml"
```

3. Sync the app with `nuon apps sync`

4. Reprovision the install and apply the new stack as a CF change-set.

## New Installs

1. Configure `runner.toml` to use the management mode init script.
2. Configure `stack.toml` to use the 1.6 version of the Runner ASG nested CF
   stack.

```toml runner.toml theme={null}
init_script_url = "https://raw.githubusercontent.com/nuonco/runner/refs/heads/main/scripts/aws/init-mng.sh"
```

2. Update `stack.toml` to use the 1.6 version of the Runner ASG nested CF stack
   `runner_nested_template_url`.

```toml stack.toml theme={null}
runner_nested_template_url = "https://nuon-artifacts.s3.us-west-2.amazonaws.com/aws-cloudformation-templates/v0.1.6/runner/asg/stack.yaml"
```

3. Carry on as usual.