---
title: CachyOS chroot-Helfer
description: Hilfsprogramm, um das Chrooten in Systeme zu erleichtern
tableOfContents:
  minHeadingLevel: 1
  maxHeadingLevel: 4
---

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

[cachy-chroot](https://github.com/CachyOS/cachy-chroot) ist ein einfaches Hilfsprogramm, das den Prozess des Chrootens in eine bestehende
CachyOS- oder Arch-basierte Installation erleichtert. Es listet alle auf dem Rechner gefundenen Partitionen auf und unterstützt auch die Auflistung von BTRFS-Subvolumes.
Zu guter Letzt unterstützt `cachy-chroot` auch verschlüsselte Systeme über LUKS. Es ordnet jeden `fstab`-Eintrag seinem entsprechenden `crypttab`-Eintrag
zu und schließt alle LUKS-Volumes beim Verlassen des Chroots ordnungsgemäß.

:::caution[cachy-chroot ist für die Ausführung in einer Live-Umgebung von CachyOS vorgesehen.]
:::

:::note
cachy-chroot unterstützt das Einhängen von so ziemlich jedem Dateisystem, das vom Linux-Kernel unterstützt wird, mit Ausnahme von ZFS.
:::

## Verwendung

:::tip
Verwenden Sie Ihre Pfeiltasten, um durch die Optionen zu navigieren, und `ENTER` zur Auswahl.

Das Symbol **❯** zeigt die aktuell ausgewählte Option an.

**?** zeigt eine Aufforderung zur Benutzereingabe an.
:::

<Steps>
1. Starten Sie von einer Live-ISO von CachyOS.
2. Öffnen Sie ein Terminal und wechseln Sie mit `sudo su` zum Root-Benutzer.
3. Stellen Sie sicher, dass Sie das neueste `cachy-chroot` installiert haben, indem Sie Folgendes ausführen:
    ```bash
    pacman -Sy cachy-chroot
    ```
4. Führen Sie `cachy-chroot` aus, indem Sie Folgendes eingeben:
    ```bash
    cachy-chroot
    ```
    `cachy-chroot` wird alle verfügbaren Partitionen scannen und auflisten.
    <details>
    <summary>Beispielausgabe bei einer CachyOS BTRFS-Installation</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>Beispielausgabe mit 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
        ```
        In diesem Beispiel ist die Root-Partition `/dev/sda1` mit dem Dateisystem `ext4`. Die anderen Partitionen sind für das Chroot nicht relevant.
    </details>
5. Wählen Sie die Partition aus, die das Root-Dateisystem enthält:
    <details>
    <summary>Beispiel mit CachyOS BTRFS</summary>
        ```bash title="Root-Partition auswählen"
        ✔ 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) › # Geben Sie 'y' ein, wenn Sie CachyOS verwenden
        ```
        **Wenn Sie CachyOS mit BTRFS verwenden**, geben Sie `y` ein, um die CachyOS BTRFS-Voreinstellung zu nutzen. Dadurch werden das Root-Subvolume und andere wichtige Subvolumes wie `/home`, `/var`, `/tmp` und `/srv` automatisch eingehängt. Wenn Sie ein benutzerdefiniertes BTRFS-Layout oder ein Nicht-CachyOS-System verwenden, geben Sie `n` ein, um die Subvolumes manuell auszuwählen.
    </details>
    <details>
    <summary>Beispiel mit EXT4</summary>
            ```bash title="Root-Partition auswählen"
            ✔ 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` wird versuchen, alle in der `/etc/fstab` des Root-Geräts aufgeführten Partitionen und Subvolumes automatisch einzuhängen. Wenn das Einhängen einiger Partitionen fehlschlägt, werden Sie benachrichtigt und erhalten die Möglichkeit, sie bei Bedarf manuell einzuhängen. Sie können `no` wählen, um das Einhängen zusätzlicher Partitionen zu überspringen.
7. **Sie befinden sich nun in der Chroot-Umgebung**.
    ```bash
    [root@CachyOS /]#
    ```
    Sie können nun Befehle ausführen, als wären Sie in das installierte System gebootet. Zum Beispiel können Sie das System aktualisieren mit:
    ```bash title="System im Chroot aktualisieren"
    pacman -Syu
    ```
    ```bash title="Zur Sicherheit dein initramfs regenerieren"
    mkinitcpio -P
    ```
    oder andere Wartungsaufgaben nach Bedarf durchführen.
8. Wenn Sie fertig sind, verlassen Sie die Chroot-Umgebung, indem Sie `exit` in die Eingabeaufforderung eingeben oder `STRG+D` auf der Tastatur drücken.
    ```bash title="Chroot verlassen"
    exit
    ```
9. Nach dem Verlassen wird `cachy-chroot` die eingehängten Partitionen automatisch bereinigen und alle LUKS-Container schließen. Sie kehren zur Shell der Live-Umgebung zurück.
</Steps>

### Fehlerbehebung

- **Keine Partitionen gefunden:** Stellen Sie sicher, dass die Festplatte mit Ihrer Installation angeschlossen ist und vom Live-System erkannt wird. Sie können dies mit `lsblk` oder `fdisk -l` überprüfen.
- **Automatisches Einhängen schlägt bei einigen Partitionen fehl:** Sie können versuchen, sie manuell aus der Chroot-Umgebung heraus einzuhängen. `cachy-chroot` wird Fehler ignorieren und fortfahren.

### FAQ

- **F: Wozu dient das Einhängen zusätzlicher Partitionen?**
  - A: Es gibt mehrere Anwendungsfälle für das manuelle Einhängen zusätzlicher Partitionen, darunter:
    - **Defekte oder fehlende fstab-Datei:** Sie können notwendige Partitionen (wie `/boot` oder `/home`) manuell einhängen, um Reparaturen oder Datenwiederherstellung durchzuführen.
    - **Aktualisierte Partitions-UUIDs:** Wenn Ihr System nicht startet, weil Sie die UUID einer Partition geändert haben, können Sie `cachy-chroot` verwenden, um die Partitionen einzuhängen und dann die fstab entsprechend zu aktualisieren.

### Mehr erfahren

- [Arch Wiki - chroot](https://wiki.archlinux.org/title/Chroot)
- [Videodemonstration von cachy-chroot](https://github.com/user-attachments/assets/29360aaf-b775-4cfa-9051-465ad5360ae8)
