---
title: Assistant chroot de CachyOS
description: Outil d'aide pour faciliter le chroot dans les systèmes
tableOfContents:
  minHeadingLevel: 1
  maxHeadingLevel: 4
---

import {Tabs, TabItem, Steps } from '@astrojs/starlight/components';

[cachy-chroot](https://github.com/CachyOS/cachy-chroot) est un programme d'aide simple pour faciliter le processus de chroot dans une installation existante de CachyOS ou basée sur Arch. Il liste toutes les partitions découvertes sur la machine et prend également en charge l'énumération des sous-volumes BTRFS.
Enfin, et ce n'est pas le moins important, `cachy-chroot` prend également en charge les systèmes chiffrés via LUKS. Il associera chaque entrée de `fstab` à ses entrées `crypttab` désignées et fermera proprement tous les volumes LUKS en quittant le chroot.

:::caution[cachy-chroot est destiné à être exécuté depuis un environnement live de CachyOS.]
:::

:::note
cachy-chroot prend en charge le montage de presque tous les systèmes de fichiers supportés par le noyau Linux, à l'exception de ZFS.
:::

## Utilisation

:::tip
Utilisez vos touches fléchées pour naviguer dans les options et `ENTRÉE` pour sélectionner.

Le symbole **❯** indique l'option actuellement sélectionnée.

**?** indique une invite de saisie pour l'utilisateur.
:::

<Steps>
1. Démarrez sur un ISO live de CachyOS
2. Ouvrez un terminal et passez à l'utilisateur root avec `sudo su`
3. Assurez-vous d'avoir la dernière version de `cachy-chroot` installée en exécutant :
    ```bash
    pacman -Sy cachy-chroot
    ```
4. Lancez `cachy-chroot` en tapant :
    ```bash
    cachy-chroot
    ```
    `cachy-chroot` va scanner et lister toutes les partitions disponibles.
    <details>
    <summary>Exemple de sortie avec une installation CachyOS BTRFS</summary>
        ```bash
        Info: Found 3 block devices
        Info: Found partition: Partition: /dev/nvme0n1p1: FS: vfat UUID: EDA6-ED98
        Info: Found partition: Partition: /dev/nvme0n1p2: FS: btrfs UUID: b09a027e-a61d-424f-858f-2e02be61b342
        Info: Found partition: Partition: /dev/nvme0n1p4: FS: btrfs UUID: 66e84339-8c77-4131-afce-50ec2cf67a80
        ? Select the block device for the root partition (use arrow keys):  ›
        Partition: /dev/nvme0n1p1: FS: vfat UUID: EDA6-ED98
        ❯ Partition: /dev/nvme0n1p2: FS: btrfs UUID: b09a027e-a61d-424f-858f-2e02be61b342
        ```
    </details>
    <details>
    <summary>Exemple de sortie avec EXT4</summary>
        ```bash
        Info: Found 8 block devices
        Info: Found partition: Partition: /dev/sda1: FS: ext4 UUID: b7fef200-fbb8-4783-9fad-46c5e8b7ca0e
        Info: Found partition: Partition: /dev/sda2: FS: vfat UUID: CA0D-2D5A
        Info: Found partition: Partition: /dev/sdb1: FS: ntfs UUID: A4763F77763F48F6
        Info: Found partition: Partition: /dev/sdc1: FS: ntfs UUID: C4CA216BCA215B46
        Info: Found partition: Partition: /dev/sdc2: FS: ntfs UUID: 060C28590C284651
        Info: Found partition: Partition: /dev/sdc3: FS: ntfs UUID: 3A3CF8B13CF86971
        Info: Found partition: Partition: /dev/sdd1: FS: exfat UUID: 4FDC-0AAB
        Info: Found partition: Partition: /dev/sdd2: FS: vfat UUID: 3105-B091
        ? Select the block device for the root partition (use arrow keys):  ›
        ❯ Partition: /dev/sda1: FS: ext4 UUID: b7fef200-fbb8-4783-9fad-46c5e8b7ca0e
        Partition: /dev/sda2: FS: vfat UUID: CA0D-2D5A
        Partition: /dev/sdb1: FS: ntfs UUID: A4763F77763F48F6
        Partition: /dev/sdc1: FS: ntfs UUID: C4CA216BCA215B46
        Partition: /dev/sdc2: FS: ntfs UUID: 060C28590C284651
        Partition: /dev/sdc3: FS: ntfs UUID: 3A3CF8B13CF86971
        Partition: /dev/sdd1: FS: exfat UUID: 4FDC-0AAB
        Partition: /dev/sdd2: FS: vfat UUID: 3105-B091
        ```
        Dans cet exemple, la partition racine est `/dev/sda1` avec le système de fichiers `ext4`. Les autres partitions ne sont pas pertinentes pour le chroot.
    </details>
5. Sélectionnez la partition qui contient le système de fichiers racine :
    <details>
    <summary>Exemple avec CachyOS BTRFS</summary>
        ```bash title="Sélection de la partition racine"
        ✔ Select the block device for the root partition (use arrow keys):  · Partition: /dev/nvme0n1p2: FS: btrfs UUID: b09a027e-a61d-424f-858f-2e02be61b342
        Info: Selected BTRFS partition, mounting and listing subvolumes...
        Info: Mounting partition /dev/nvme0n1p2 at /tmp/cachyos-chroot-temp-mount-b09a027e-a61d-424f-858f-2e02be61b342-hwAeIm with options: []
        Info: Unmounting partition at /tmp/cachyos-chroot-temp-mount-b09a027e-a61d-424f-858f-2e02be61b342-hwAeIm
        ? Do you want to use CachyOS BTRFS preset to auto mount root subvolume? (y/n) › # Entrez oui si sur CachyOS
        ```
        **Si vous utilisez CachyOS avec BTRFS**, entrez `y` pour utiliser le préréglage BTRFS de CachyOS. Cela montera automatiquement le sous-volume racine et d'autres sous-volumes importants tels que `/home`, `/var`, `/tmp` et `/srv`. Si vous utilisez une disposition BTRFS personnalisée ou un système non-CachyOS, entrez `n` pour sélectionner manuellement les sous-volumes.
    </details>
    <details>
    <summary>Exemple avec EXT4</summary>
            ```bash title="Sélection de la partition racine"
            ✔ Select the block device for the root partition (use arrow keys):  · Partition: /dev/sda1: FS: ext4 UUID: b7fef200-fbb8-4783-9fad-46c5e8b7ca0e
            Info: Mounting partition /dev/sda1 at /tmp/cachyos-chroot-root-mount-b7fef200-fbb8-4783-9fad-46c5e8b7ca0e-LtsXXC with options: []
            Info: Mounting additional partitions based on /etc/fstab...
            Info: Found 3 entries in /etc/fstab
            Warning: Partition UUID=b7fef200-fbb8-4783-9fad-46c5e8b7ca0e already mounted, skipping...
            Info: Mounting partition /dev/sda2 at /tmp/cachyos-chroot-root-mount-b7fef200-fbb8-4783-9fad-46c5e8b7ca0e-LtsXXC/boot with options: []
            Info: Finished mounting additional partitions
            ✔ Do you want to mount additional partitions? · no
            Info: Chrooting into the configured root partition...
            Info: To exit the chroot, type 'exit' or press Ctrl+D
            ```
    </details>
6. `cachy-chroot` tentera de monter automatiquement toutes les partitions et sous-volumes listés dans `/etc/fstab` du périphérique racine. Si le montage de certaines partitions échoue, vous en serez informé et aurez la possibilité de les monter manuellement si nécessaire. Vous pouvez choisir `no` pour ignorer le montage de partitions supplémentaires.
7. **Vous êtes maintenant dans l'environnement chroot**.
    ```bash
    [root@CachyOS /]#
    ```
    Vous pouvez maintenant exécuter des commandes comme si vous aviez démarré sur le système installé. Par exemple, vous pouvez mettre à jour le système avec :
    ```bash title="Mise à jour du système en chroot"
    pacman -Syu
    ```
    ou effectuer d'autres tâches de maintenance selon les besoins.
8. Lorsque vous avez terminé, quittez l'environnement chroot en tapant `exit` à l'invite ou en appuyant sur `CTRL+D` sur le clavier.
    ```bash title="Sortie du chroot"
    exit
    ```
9. Après être sorti, `cachy-chroot` nettoiera automatiquement les partitions montées et fermera tous les conteneurs LUKS. Vous retournerez au shell de l'environnement live.
</Steps>

### Dépannage

- **Aucune partition trouvée :** Assurez-vous que le disque contenant votre installation est connecté et reconnu par le système live. Vous pouvez vérifier avec `lsblk` ou `fdisk -l`.
- **L'automontage échoue pour certaines partitions :** Vous pouvez essayer de les monter manuellement depuis l'environnement chroot. `cachy-chroot` ignorera les échecs et continuera.

### FAQ

- **Q : À quoi sert le montage de partitions supplémentaires ?**
  - R : Il existe plusieurs cas d'utilisation pour le montage manuel de partitions supplémentaires, notamment :
    - **Fichier fstab cassé ou manquant :** Vous pouvez monter manuellement les partitions nécessaires (telles que `/boot` ou `/home`) pour effectuer des réparations ou de la récupération de données.
    - **UUID de partition mis à jour :** Si votre système ne démarre pas parce que vous avez changé l'UUID d'une partition, vous pouvez utiliser `cachy-chroot` pour monter les partitions puis mettre à jour le fstab en conséquence.

### En savoir plus

- [Arch Wiki - chroot](https://wiki.archlinux.org/title/Chroot)
- [Démonstration vidéo de cachy-chroot](https://github.com/user-attachments/assets/29360aaf-b775-4cfa-9051-465ad5360ae8)
