# upgrade

upgrade the installed packages

The step refreshes the package index, also during the plan, and checks for pending upgrades.

## Keys

| Key | Type | Default | Meaning |
| --- | --- | --- | --- |
| [`mode`](#upgrade.mode) | string | required | safe or full |

### `upgrade.mode` {#upgrade.mode}

string, required

Safe or full. safe installs the upgrades that remove no package. full also installs the upgrades that add or remove packages.

## Example

```yaml
- upgrade:
    mode: safe
```