Skip to main content
The pixi reinstall command reinstalls environments, updating the lockfile if needed and reinstalling packages from scratch.

​
Usage

pixi reinstall [OPTIONS] [PACKAGE]...

​
Arguments

​
PACKAGE
string
Specific package(s) to reinstall. If not provided, the entire environment is reinstalled.Multiple packages can be specified.
pixi reinstall numpy pandas
pixi reinstall python

​
Behavior

​
Full Environment Reinstall

When no packages are specified, the entire environment is reinstalled: 
pixi reinstall
This will:
  1. Update the lockfile if it’s out of date
  2. Remove all installed packages in the environment
  3. Reinstall all packages from the lockfile

​
Selective Package Reinstall

When specific packages are provided, only those packages are reinstalled: 
pixi reinstall numpy scipy
This reinstalls only the specified packages and their dependencies.

​
Options

​
Environment Selection

​
--environment
string
The environment to reinstall. Can be specified multiple times to reinstall multiple environments.Short flag: -eDefaults to the default environment if not specified.
pixi reinstall --environment test
pixi reinstall --environment prod --environment dev

​
All Environments

​
--all
boolean
default:"false"
Reinstall all environments in the workspace.Short flag: -aConflicts with --environment.
pixi reinstall --all
Use --all to reinstall every environment defined in your workspace in one command.

​
Lock File Options

​
--frozen
boolean
default:"false"
Reinstall using the existing lock file without updating it.Env: PIXI_FROZEN
​
--locked
boolean
default:"false"
Check if lock file is up-to-date before reinstalling. Abort if not.Env: PIXI_LOCKED
pixi reinstall --frozen
pixi reinstall --locked

​
Examples

​
Reinstall Default Environment

pixi reinstall
Reinstalls all packages in the default environment.

​
Reinstall Specific Environment

pixi reinstall --environment ml
Reinstalls all packages in the “ml” environment.

​
Reinstall Multiple Environments

pixi reinstall --environment dev --environment test
Reinstalls both “dev” and “test” environments.

​
Reinstall All Environments

pixi reinstall --all
Reinstalls every environment in the workspace.

​
Reinstall Specific Packages

pixi reinstall numpy pandas matplotlib
Reinstalls only numpy, pandas, and matplotlib (and their dependencies) in the default environment.

​
Reinstall Package in Specific Environment

pixi reinstall python --environment prod
Reinstalls Python in the “prod” environment.

​
Reinstall Without Updating Lock

pixi reinstall --frozen
Reinstalls using the exact versions in the current lock file.

​
When to Use Reinstall

​
Corrupted Environment

If your environment is corrupted or packages are in an inconsistent state: 
pixi reinstall

​
After System Changes

After system updates or when packages aren’t behaving correctly: 
pixi reinstall --environment affected-env

​
Testing Clean Installation

To verify that all dependencies install correctly from scratch: 
pixi reinstall --all

​
Package Conflicts

When experiencing package conflicts or import errors: 
pixi reinstall conflicting-package

​
Comparison with Other Commands

​
reinstall vs install

  • pixi install: Installs missing packages, keeps existing ones
  • pixi reinstall: Removes and reinstalls packages, ensuring clean state

​
reinstall vs update

  • pixi update: Updates packages to newer versions within constraints
  • pixi reinstall: Reinstalls current versions from lockfile

​
reinstall vs upgrade

  • pixi upgrade: Upgrades to latest versions, updating lockfile
  • pixi reinstall: Reinstalls without changing versions (unless lockfile is updated)

​
Global Options

​
--manifest-path
string
Path to pixi.toml, pyproject.toml, or workspace directory.Short flag: -m
pixi reinstall --manifest-path /path/to/project

​
Config Options

These options override global configuration:
  • --tls-no-verify: Disable TLS verification
  • --auth-file <FILE>: Path to authentication file
  • --pypi-keyring-provider <PROVIDER>: Keyring provider for PyPI

​
Troubleshooting

​
Environment Not Found

Error: environment 'xyz' not found Solution: Check available environments: 
pixi list --environments
pixi reinstall --environment correct-name

​
Lock File Out of Date

Error: lock file is out of date Solution: Update the lock file or use --frozen: 
# Update lock file and reinstall
pixi reinstall

# Or use existing lock file
pixi reinstall --frozen

​
Package Not in Environment

Error: package 'xyz' not found in environment Solution: Verify the package is in the environment: 
pixi list
pixi add xyz
pixi reinstall xyz

​
Performance Notes

Reinstalling specific packages is faster than reinstalling the entire environment.
For large environments: 
# Faster - only reinstalls numpy
pixi reinstall numpy

# Slower - reinstalls everything
pixi reinstall

​
See Also