# atmos version track update

Advance locked versions to the newest candidates allowed by each entry's effective update policy, then write the lock file.

Unlike [`lock`](/cli/commands/version/track/lock), `update` starts from the locked state and respects strategy caps, cooldown windows, include/exclude rules, and prerelease policy. Newer candidates held back by policy are reported with a reason.

## Usage

```shell
atmos version track update [track] [flags]
```

## Flags

- **`--group`**
  Limit the update to entries in the named version group.
- **`--only`**
  Limit the update to the named entries. Repeat the flag for multiple entries.

## Examples

```shell
# Update every entry in the default track within policy
atmos version track update

# Update only the infrastructure group in prod
atmos version track update prod --group=infrastructure

# Update two specific entries
atmos version track update prod --only=checkout --only=nginx
```

Example output:

```yaml
track: prod
results:
  - name: checkout
    from: v6.1.0
    to: v6.2.0
    updated: true
  - name: nginx
    from: 1.29.0
    updated: false
    reason: "1.30.0 released 3d ago; cooldown 14d has not elapsed"
```