pixi reinstall

Reinstall environments and packages in your pixi workspace

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: -e

Defaults 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: -a

Conflicts 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

• pixi install - Install dependencies
• pixi update - Update dependencies
• pixi upgrade - Upgrade dependencies to latest versions
• pixi clean - Clean up workspace cache