Commandes Nix classiques : nix-env, nix-build, nix-shell, nix-channel

Les commandes nix-env, nix-build, nix-shell et nix-channel constituent l’interface historique de Nix. Elles sont progressivement remplacées par les commandes modernes (nix search, nix shell, nix run, nix profile…), mais vous les rencontrerez encore dans de nombreux tutoriels, wikis et scripts existants. Ce guide les présente avec leur équivalent moderne pour vous permettre de lire et adapter le code legacy.

Ce que vous allez apprendre

• Identifier les commandes classiques et comprendre leur rôle
• Utiliser nix-build et nix-shell (les deux plus utiles encore aujourd’hui)
• Comprendre pourquoi nix-env est incompatible avec nix profile
• Gérer les channels avec nix-channel et comprendre le passage aux flakes
• Traduire chaque commande classique vers son équivalent moderne

Dans quel contexte ?

Vous croiserez les commandes classiques dans plusieurs situations :

• lire un tutoriel ou un README qui utilise nix-shell -p ou nix-build,
• maintenir un projet qui utilise un shell.nix ou default.nix,
• déboguer une installation sur une machine configurée avec les anciens channels,
• migrer progressivement un workflow basé sur nix-env vers nix profile.

Attention

Les commandes modernes (nix profile) et classiques (nix-env) utilisent des formats de profil incompatibles. Si vous avez déjà utilisé nix profile add, nix-env refusera de fonctionner sur le même profil :

error: profile "/home/lab/.local/state/nix/profiles/profile"
is incompatible with 'nix-env'; please use 'nix profile' instead

Choisissez l’un ou l’autre pour gérer vos paquets installés.

nix-build — construire un paquet

nix-build est l’ancêtre de nix build. Il évalue une expression Nix, construit le résultat et crée un lien symbolique result :

nix-build '<nixpkgs>' -A hello

Résultat

/nix/store/10s5j3mfdg22k1597x580qrhprnzcjwb-hello-2.12.3

./result/bin/hello

Résultat

Hello, world!

Différences avec nix build

Aspect	nix-build	nix build
Syntaxe source	'<nixpkgs>' -A hello	nixpkgs#hello
Résolution	Channels (NIX_PATH)	Registres flakes
Sortie	Chemin store sur stdout	Lien result (silencieux)
Pinning	Manuel (pas de lock)	flake.lock automatique

Glissez pour voir

Astuce

nix-build reste utile pour construire des expressions locales qui ne sont pas encore migrées en flakes. Un default.nix à la racine d’un projet fonctionne directement avec nix-build.

nix-shell — un shell avec des dépendances

nix-shell crée un environnement shell temporaire. C’est l’ancêtre de nix shell et nix develop.

Utilisation rapide avec -p

nix-shell -p cowsay --run 'cowsay "nix-shell classique"'

Résultat

 _____________________
< nix-shell classique >
 ---------------------
        \   ^__^
         \  (oo)\_______
            (__)\       )\/\
                ||----w |
                ||     ||

Combiner plusieurs paquets

nix-shell -p curl jq --run 'echo "curl et jq disponibles"'

Résultat

curl et jq disponibles

Avec un fichier shell.nix

L’usage le plus courant de nix-shell est avec un fichier shell.nix à la racine d’un projet :

shell.nix

{ pkgs ? import <nixpkgs> {} }:
pkgs.mkShell {
  buildInputs = [
    pkgs.python3
    pkgs.curl
    pkgs.jq
  ];
}

nix-shell
# → shell interactif avec python3, curl et jq

Différences avec les commandes modernes

Aspect	nix-shell -p pkg	nix shell nixpkgs#pkg
Résolution	Channels (NIX_PATH)	Registre flakes
Environnement	Ajoute stdenv complet	Ajoute uniquement le paquet
Fichier projet	shell.nix	flake.nix → devShells

Glissez pour voir

Aspect	nix-shell (fichier)	nix develop
Fichier	shell.nix	flake.nix
Pinning	Manuel	flake.lock automatique
Reproductibilité	Dépend de NIX_PATH	Garantie par le lock

Glissez pour voir

Note

nix-shell -p ajoute le stdenv complet (compilateur, make, sed, grep…) dans l’environnement, ce qui explique les nombreux paquets téléchargés. Les commandes modernes nix shell n’ajoutent que le paquet demandé.

nix-env — gérer les paquets du profil

nix-env est l’ancêtre de nix profile. Il permet de chercher, installer, lister et supprimer des paquets dans le profil utilisateur.

Commandes principales

# Chercher un paquet
nix-env -qaP '.*htop.*'

# Installer
nix-env -iA nixpkgs.htop

# Lister les paquets installés
nix-env -q

# Supprimer
nix-env -e htop

# Mettre à jour tout
nix-env -u

# Rollback
nix-env --rollback

# Lister les générations
nix-env --list-generations

Pourquoi éviter nix-env

nix-env présente plusieurs limites :

1. Incompatible avec nix profile — les deux formats de profil sont mutuellement exclusifs.
2. Pas de pinning — la version installée dépend de l’état du channel au moment de l’installation.
3. Résolution par nom — nix-env -i htop peut installer un paquet inattendu si plusieurs correspondent.
4. Pas de flake.lock — impossible de reproduire exactement le même environnement.

Table de correspondance

nix-env	nix profile
nix-env -qaP pattern	nix search nixpkgs pattern
nix-env -iA nixpkgs.pkg	nix profile add nixpkgs#pkg
nix-env -q	nix profile list
nix-env -e pkg	nix profile remove pkg
nix-env -u	nix profile upgrade '.*'
nix-env --rollback	nix profile rollback
nix-env --list-generations	nix profile history

Glissez pour voir

nix-channel — gérer les sources de paquets

Les channels sont l’ancien mécanisme pour résoudre <nixpkgs> vers une version spécifique de l’arbre nixpkgs.

Commandes principales

# Lister les channels configurés
nix-channel --list

# Ajouter un channel
nix-channel --add https://nixos.org/channels/nixpkgs-unstable nixpkgs

# Mettre à jour
nix-channel --update

Channels vs flakes

Aspect	Channels	Flakes
Verrouillage	Non (rolling)	Oui (flake.lock)
Reproductibilité	Dépend du moment	Garantie par le hash
Configuration	Globale (~/.nix-channels)	Par projet (flake.nix)
Résolution	<nixpkgs> via NIX_PATH	nixpkgs via registre

Glissez pour voir

Astuce

Avec les commandes modernes et les flakes, les channels ne sont plus nécessaires. La référence nixpkgs#paquet résout automatiquement vers le registre par défaut. Pour pinning un projet, utilisez un flake.nix avec flake.lock.

Autres commandes classiques

nix-instantiate — évaluer une dérivation

nix-instantiate '<nixpkgs>' -A hello

Résultat

/nix/store/7mdg60drrnh0wq1j8hmmbhll47czm107-hello-2.12.3.drv

Équivalent moderne : nix derivation show nixpkgs#hello

nix-collect-garbage — libérer de l’espace

# Supprimer les paquets non référencés
nix-collect-garbage

# Supprimer aussi les anciennes générations de plus de 30 jours
nix-collect-garbage -d --delete-older-than 30d

Équivalent moderne : nix profile wipe-history + nix store gc

nix-store — opérations sur le store

# Afficher les dépendances d'un chemin
nix-store -q --references /nix/store/922c...-ripgrep-15.1.0

# Afficher les référents (qui dépend de ce chemin)
nix-store -q --referrers /nix/store/922c...-ripgrep-15.1.0

# Vérifier l'intégrité du store
nix-store --verify --check-contents

Table de correspondance complète

Classique	Moderne	Usage
nix-env -qaP	nix search	Chercher
nix-env -iA	nix profile add	Installer
nix-env -e	nix profile remove	Supprimer
nix-env -u	nix profile upgrade	Mettre à jour
nix-env --rollback	nix profile rollback	Rollback
nix-build	nix build	Construire
nix-shell -p	nix shell	Shell temporaire
nix-shell (fichier)	nix develop	Env. de développement
nix-channel	Registres flakes	Sources de paquets
nix-instantiate	nix derivation show	Inspecter la dérivation
nix-collect-garbage	nix store gc	Garbage collection
nix-store -q	nix path-info	Info store

Glissez pour voir

À retenir

• nix-build et nix-shell restent fonctionnels et utiles pour les projets qui utilisent default.nix ou shell.nix.
• nix-env et nix profile sont mutuellement incompatibles — si vous utilisez les commandes modernes, n’utilisez pas nix-env.
• Les channels sont remplacés par les registres flakes qui offrent un verrouillage automatique via flake.lock.
• Pour un nouveau projet, préférez les commandes modernes et les flakes — les commandes classiques sont utiles principalement pour comprendre le code legacy.
• nix-shell -p importe le stdenv complet, ce qui est plus lourd que nix shell qui n’ajoute que le paquet demandé.

Prochaines étapes

Commandes modernes Nix Passez aux commandes modernes : nix search, nix shell, nix run, nix build.

Le langage Nix Comprenez le langage pour écrire vos propres expressions et dérivations.

Les flakes Découvrez les flakes pour des projets reproductibles et verrouillés.

×

📖 Voir la documentation →