Skip to main content

​
jnc config

Manages jnc configuration files. Configuration can be set at three scopes: system (machine-wide), global (user-wide), and local (workspace-specific via pixi.toml).

​
Usage

jnc config <SUBCOMMAND>

​
Subcommands

​
edit

Open the configuration file in your default editor. 
jnc config edit
jnc config edit --system
jnc config edit --global
jnc config edit --local

​
list

Display current configuration values. 
jnc config list [OPTIONS]
OptionDescription
--jsonOutput in JSON format
--systemShow system-level configuration
--globalShow global (user-level) configuration
--localShow local (workspace-level) configuration

​
set

Set a configuration value. 
jnc config set <KEY> <VALUE>

​
unset

Remove a configuration value. 
jnc config unset <KEY>

​
append

Append a value to a list-type configuration key. 
jnc config append <KEY> <VALUE>

​
prepend

Prepend a value to a list-type configuration key. 
jnc config prepend <KEY> <VALUE>

​
Global Options

OptionShortDescription
--manifest-path-mPath to pixi.toml or pyproject.toml

​
Configuration Scopes

ScopeDescription
systemMachine-wide configuration, applies to all users
globalUser-wide configuration, applies to all workspaces
localWorkspace-specific configuration, stored in pixi.toml
When the same key is set at multiple scopes, the most specific scope wins: local overrides global, which overrides system.

​
Examples

# Set the default channel globally
jnc config set default-channels '["conda-forge"]'

# List all configuration values as JSON
jnc config list --json

# Add a channel to the default list
jnc config append default-channels bioconda

# Remove a configuration value
jnc config unset default-channels

# Edit the global configuration file
jnc config edit --global

# View only local (workspace) configuration
jnc config list --local