---
title: CachyOS chroot Helper
description: Ferramenta auxiliar para facilitar o processo de chroot em sistemas
tableOfContents:
  minHeadingLevel: 1
  maxHeadingLevel: 4
ai_translated: true
---

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

O [cachy-chroot](https://github.com/CachyOS/cachy-chroot) é um programa auxiliar simples para facilitar o processo de realizar chroot numa instalação existente do
CachyOS ou de qualquer sistema baseado em Arch. Este lista todas as partições detetadas na máquina e também suporta a listagem de subvolumes BTRFS.
Por último, mas não menos importante, o `cachy-chroot` também suporta sistemas encriptados via LUKS. Este mapeia cada entrada do `fstab` para as suas respetivas entradas no `crypttab`
e encerra de forma segura todos os volumes LUKS ao sair do chroot.

:::caution[O cachy-chroot foi concebido para ser executado a partir de um ambiente live do CachyOS.]
:::

:::note
O cachy-chroot suporta a montagem de quase todos os sistemas de ficheiros suportados pelo kernel Linux, exceto ZFS.
:::

## Utilização

:::tip
Utilize as teclas de seta para navegar nas opções e `ENTER` para selecionar.

O símbolo **❯** indica a opção selecionada no momento.

O símbolo **?** indica um pedido de introdução de dados pelo utilizador (prompt).
:::

<Steps>
1. Inicie o sistema através de um ISO live do CachyOS
2. Abra um terminal e aceda ao utilizador root com `sudo su`
3. Certifique-se de que tem a versão mais recente do `cachy-chroot` instalada, executando:
    ```bash
    pacman -Sy cachy-chroot
    ```
4. Execute o cachy-chroot escrevendo:
    ```bash
    cachy-chroot
    ```
    `cachy-chroot` irá analisar e listar todas as partições disponíveis.
    <details>
    <summary>Exemplo de saída com instalação BTRFS do 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>Exemplo de saída com 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
        ```
        Neste exemplo, a partição root é `/dev/sda1` com o sistema de ficheiros `ext4`. As outras partições não são relevantes para o chroot.
    </details>
5. Selecione a partição que contém o sistema de ficheiros root:
    <details>
    <summary>Exemplo com CachyOS BTRFS</summary>
        ```bash title="Selecionar a partição root"
        ✔ 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) › # Introduza "s" (yes) se estiver no CachyOS
        ```
        **Se estiver a utilizar o CachyOS com BTRFS**, introduza `y` para utilizar a predefinição BTRFS do CachyOS. Isto irá montar automaticamente o subvolume root e outros subvolumes importantes, tais como `/home`, `/var`, `/tmp` e `/srv`. Se estiver a utilizar um esquema BTRFS personalizado ou um sistema que não seja CachyOS, introduza `n` para selecionar os subvolumes manualmente.
    </details>
    <details>
    <summary>Exemplo com EXT4</summary>
            ```bash title="Selecionar a partição root"
            ✔ 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. O `cachy-chroot` tentará montar automaticamente todas as partições e subvolumes listados no `/etc/fstab` do dispositivo root. Se alguma partição falhar ao ser montada, será notificado e ser-lhe-á dada a opção de as montar manualmente, se necessário. Pode escolher `no` para ignorar a montagem de partições adicionais.
7. **Está agora no ambiente chroot**.
    ```bash
    [root@CachyOS /]#
    ```
    Agora pode executar comandos como se tivesse iniciado no sistema instalado. Por exemplo, pode atualizar o sistema com:
    ```bash title="Atualizar o sistema em chroot"
    pacman -Syu
    ```
    ```bash title="Regenerar o initramfs por precaução"
    mkinitcpio -P
    ```
    ou realizar outras tarefas de manutenção conforme necessário.
8. Quando terminar, saia do ambiente chroot passando `exit` no prompt ou premindo `CTRL+D` no teclado.
    ```bash title="Sair do chroot"
    exit
    ```
9. Após sair, o `cachy-chroot` irá limpar automaticamente as partições montadas e fechar quaisquer contentores LUKS. Voltará à shell do ambiente live.
</Steps>

### Resolução de problemas

- **Nenhuma partição encontrada:** Certifique-se de que o disco que contém a sua instalação está ligado e reconhecido pelo sistema live. Pode verificar com `lsblk` ou `fdisk -l`.
- **A montagem automática falha para algumas partições:** Pode tentar montá-las manualmente a partir do ambiente chroot. O `cachy-chroot` irá ignorar as falhas e continuar.

### FAQ

- **P: Qual é a utilidade de montar partições adicionais?**
  - R: Existem vários casos de utilização para a montagem manual de partições adicionais, incluindo:
    - **Ficheiro fstab corrompido ou em falta:** Pode montar manualmente as partições necessárias (como `/boot` ou `/home`) para efetuar reparações ou recuperação de dados.
    - **UUIDs de partição atualizados:** Se o seu sistema não estiver a arrancar porque alterou o UUID de uma partição, pode utilizar o `cachy-chroot` para montar as partições e depois atualizar o fstab em conformidade.

### Saber mais

- [Arch Wiki - chroot](https://wiki.archlinux.org/title/Chroot)
- [Demonstração em vídeo do cachy-chroot](https://github.com/user-attachments/assets/29360aaf-b775-4cfa-9051-465ad5360ae8)