Skip to main content

jnc upgrade

Checks if there are newer versions of dependencies and upgrades them by loosening the version constraints in the manifest file. Unlike jnc update, which respects existing version constraints, upgrade temporarily removes version pins to find the latest available versions, then updates both the lock file and the manifest. By default, all features and their dependencies are upgraded.

Usage

jnc upgrade [OPTIONS] [PACKAGES]...

Arguments

ArgumentDescription
[PACKAGES]...The packages to upgrade. If none are provided, all packages across all features are upgraded.

Options

OptionShortDescription
--feature <FEATURE>-fOnly upgrade packages in the specified feature. If not given, all features are upgraded.
--exclude <PACKAGES>Exclude specific packages from the upgrade. Cannot be used with positional package arguments.
--dry-run-nShow what would be changed without modifying the manifest, lock file, or environment.
--jsonOutput the changes in JSON format.
--no-installUpdate the lock file and manifest without installing the environment.
--frozenUse the lock file as-is. Do not update it if it is out of date.
--lockedRequire the lock file to be up-to-date. Abort if it is not.

Global Options

OptionShortDescription
--manifest-path <PATH>-mPath to pixi.toml or the workspace directory.

Examples

Upgrade all dependencies:
jnc upgrade
Upgrade specific packages:
jnc upgrade python numpy
Upgrade only in a specific feature:
jnc upgrade --feature cuda
Upgrade everything except certain packages:
jnc upgrade --exclude python
Preview changes without applying:
jnc upgrade --dry-run
Output changes as JSON:
jnc upgrade --json