# atmos version track set

Adjust a tracked dependency's desired version or update policy without editing YAML by hand. Only
the settings you specify are changed, and the file's comments and formatting are preserved.

## Usage

```shell
atmos version track set NAME [flags]
```

## Arguments

- **`NAME` required** — Entry name to update.

## Flags

- **`--desired`** — Desired version: concrete, SemVer constraint, or `latest`.
- **`--package`** — Package coordinate.
- **`--provider`** — Provider name from `version.providers`.
- **`--group`** — Version group name.
- **`--pin`** — Pin policy: `digest`, `sha`, or `none`.
- **`--include`** — Candidate version patterns to include. Repeat the flag for multiple patterns.
- **`--exclude`** — Candidate version patterns to exclude. Repeat the flag for multiple patterns.
- **`--prerelease`** — Allow or disallow prerelease candidates for this entry.

## Examples

```shell
# Move checkout to the v6 desired range
atmos version track set checkout --desired=v6

# Render nginx with an immutable OCI digest
atmos version track set nginx --pin=digest

# Exclude a known vulnerable release and keep prereleases disabled
atmos version track set checkout --exclude=v6.0.0 --prerelease=false

# Move an entry into a group on prod
atmos version track set opentofu --track=prod --group=infrastructure
```

## Try it out

### version-tracker

Copy the example into a new directory and make it your own:

```shell
atmos init examples/version-tracker
cd version-tracker
```

Change the desired redis version in your local dev track. No cloud credentials are needed.

```shell
atmos version track set redis --desired 7.4.1 --track dev
```

- [Installation guide](/install)
- [Explore the example](/examples/version-tracker)
- [Initialization and repository settings](/cli/commands/init#examples-and-source-directories)