Sharing manifests#

The global.toml manifest is a plain text file that describes all your globally installed tools. You can share it across machines to replicate your setup.

Export your current setup#

The manifest path varies by platform (see Configuration). Copy it to a new machine or keep it in a dotfiles repository:

cp "$(conda global info --manifest)" ~/dotfiles/conda-global.toml

On the target machine, place the file in the data directory and run conda global sync.

Sync on the new machine#

Edit the manifest and sync to reconcile

After placing the manifest, run:

conda global sync

This creates any missing environments, installs the specified packages, and deploys trampolines for all exposed binaries.

Example manifest#

[envs.gh]
channels = ["conda-forge"]
dependencies = { gh = "*" }
exposed = { gh = "gh" }

[envs.ruff]
channels = ["conda-forge"]
dependencies = { ruff = ">=0.4" }
exposed = { ruff = "ruff" }
pinned = true

[envs.bat]
channels = ["conda-forge"]
dependencies = { bat = "*" }
exposed = { bat = "bat", batcat = "bat" }

Version control tips#

Commit global.toml to your dotfiles repo
Use conda global pin for tools where version stability matters
Use version specs (>=0.4) instead of * for critical tools
Run conda global sync as part of your machine bootstrap script

Tip

conda global sync is idempotent. Running it on a machine that already has all tools installed is a no-op — it only creates missing environments and deploys missing trampolines.