---
title: Asistente de chroot de CachyOS
description: Herramienta de ayuda para facilitar el proceso de chroot en sistemas
tableOfContents:
  minHeadingLevel: 1
  maxHeadingLevel: 4
ai_translated: true
---

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

[cachy-chroot](https://github.com/CachyOS/cachy-chroot) es un programa de ayuda simple para facilitar el proceso de hacer chroot en una instalación existente
de CachyOS o basada en Arch. Lista todas las particiones descubiertas en la máquina y también soporta listar subvolúmenes BTRFS.
Por último, pero no menos importante, `cachy-chroot` también soporta sistemas cifrados a través de LUKS. Mapeará cada entrada de `fstab` a sus correspondientes entradas de `crypttab`
y cerrará correctamente todos los volúmenes LUKS al salir del chroot.

:::caution[cachy-chroot está diseñado para ser ejecutado desde un entorno live de CachyOS.]
:::

:::note
cachy-chroot soporta el montaje de prácticamente cualquier sistema de archivos soportado por el kernel de Linux, a excepción de ZFS.
:::

## Uso

:::tip
Usa las teclas de flecha para navegar por las opciones y `ENTER` para seleccionar.

El símbolo **❯** indica la opción actualmente seleccionada.

**?** indica una solicitud de entrada del usuario.
:::

<Steps>
1. Arranca en una ISO live de CachyOS.
2. Abre una terminal y entra como usuario root con `sudo su`.
3. Asegúrate de tener la última versión de `cachy-chroot` instalada ejecutando:
    ```bash
    pacman -Sy cachy-chroot
    ```
4. Ejecuta `cachy-chroot` escribiendo:
    ```bash
    cachy-chroot
    ```
    `cachy-chroot` escaneará y listará todas las particiones disponibles.
    <details>
    <summary>Ejemplo de salida con una instalación BTRFS de CachyOS</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>Ejemplo de salida con 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
        ```
        En este ejemplo, la partición raíz es `/dev/sda1` con el sistema de archivos `ext4`. Las otras particiones no son relevantes para el chroot.
    </details>
5. Selecciona la partición que contiene el sistema de archivos raíz:
    <details>
    <summary>Ejemplo con BTRFS de CachyOS</summary>
        ```bash title="Seleccionando la partición raíz"
        ✔ 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) › # Introduce 'y' si estás en CachyOS
        ```
        **Si usas CachyOS con BTRFS**, introduce `y` para usar la configuración predeterminada de BTRFS de CachyOS. Esto montará automáticamente el subvolumen raíz y otros subvolúmenes importantes como `/home`, `/var`, `/tmp` y `/srv`. Si estás usando una configuración BTRFS personalizada o un sistema que no es CachyOS, introduce `n` para seleccionar los subvolúmenes manualmente.
    </details>
    <details>
    <summary>Ejemplo con EXT4</summary>
            ```bash title="Seleccionando la partición raíz"
            ✔ 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` intentará montar automáticamente todas las particiones y subvolúmenes listados en `/etc/fstab` del dispositivo raíz. Si alguna partición no se puede montar, se te notificará y se te dará la opción de montarla manualmente si es necesario. Puedes elegir `no` para omitir el montaje de particiones adicionales.
7. **Ahora estás en el entorno chroot**.
    ```bash
    [root@CachyOS /]#
    ```
    Ahora puedes ejecutar comandos como si hubieras arrancado en el sistema instalado. Por ejemplo, puedes actualizar el sistema con:
    ```bash title="Actualizando el sistema en chroot"
    pacman -Syu
    ```
    ```bash title="Regenera tu initramfs por si acaso"
    mkinitcpio -P
    ```
    o realizar otras tareas de mantenimiento según sea necesario.
8. Cuando termines, sal del entorno chroot introduciendo `exit` en la terminal o presionando `CTRL+D` en el teclado.
    ```bash title="Saliendo del chroot"
    exit
    ```
9. Después de salir, `cachy-chroot` limpiará automáticamente las particiones montadas y cerrará cualquier contenedor LUKS. Volverás a la shell del entorno live.
</Steps>

### Solución de problemas

- **No se encontraron particiones:** Asegúrate de que el disco que contiene tu instalación esté conectado y sea reconocido por el sistema live. Puedes verificarlo con `lsblk` o `fdisk -l`.
- **El montaje automático falla para algunas particiones:** Puedes intentar montarlas manualmente desde dentro del entorno chroot. `cachy-chroot` ignorará los fallos y continuará.

### Preguntas frecuentes

- **P: ¿Para qué sirve montar particiones adicionales?**
  - R: Hay varios casos de uso para montar manualmente particiones adicionales, incluyendo:
    - **Archivo fstab roto o ausente:** Puedes montar manualmente las particiones necesarias (como `/boot` o `/home`) para realizar reparaciones o recuperación de datos.
    - **UUID de partición actualizados:** Si tu sistema no arranca porque cambiaste el UUID de una partición, puedes usar `cachy-chroot` para montar las particiones y luego actualizar el fstab correspondientemente.

### Aprende más

- [Arch Wiki - chroot](https://wiki.archlinux.org/title/Chroot)
- [Demostración en video de cachy-chroot](https://github.com/user-attachments/assets/29360aaf-b775-4cfa-9051-465ad5360ae8)
