Skip to content

Commit 898271d

Browse files
committed
FAQ & Troubleshooting: Added bootloader recovery guide
1 parent 8f23424 commit 898271d

File tree

1 file changed

+78
-0
lines changed
  • src/content/docs/cachyos_basic

1 file changed

+78
-0
lines changed

src/content/docs/cachyos_basic/faq.mdx

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,84 @@ This is why it can take a bit of time to load the installer.
4444

4545
This happens when the installer is struggling to download packages. It's usually a sign of a very slow or unstable internet connection. Please check your network connection and try again.
4646

47+
## Bootloader Recovery
48+
49+
:::note[In case of a deleted /boot partition. Please create a new one following the respective [partition scheme](/installation/installation_on_root#uefigpt) from step 5.]
50+
:::
51+
52+
### Steps to recover your bootloader
53+
54+
<Steps>
55+
1. Boot into the CachyOS Live ISO.
56+
2. Open a terminal and chroot into your installed system using the `cachy-chroot` command.
57+
58+
```bash
59+
sudo cachy-chroot
60+
```
61+
If your system is utilizing BTRFS with our preset say `y` in the prompt:
62+
```bash title='Example'
63+
Do you want to use CachyOS BTRFS preset to auto mount root subvolume? y
64+
Do you want to mount additional partitions? · yes
65+
Enter the mount point for additional partition (e.g. /boot) type 'skip' to cancel:
66+
# Type /boot for systemd-boot, Limine or rEFInd
67+
# Type /boot/efi for GRUB
68+
```
69+
3. Follow the instructions below for your installed bootloader and system type (UEFI or MBR/BIOS).
70+
<Tabs>
71+
<TabItem label='GRUB'>
72+
Reinstall GRUB with the following command:
73+
<Tabs>
74+
<TabItem label='UEFI'>
75+
```bash
76+
sudo grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=cachyos
77+
```
78+
</TabItem>
79+
<TabItem label='MBR/BIOS'>
80+
```bash
81+
sudo grub-install --target=i386-pc /dev/sdX # Replace sdX with your disk e.g. sda
82+
```
83+
</TabItem>
84+
</Tabs>
85+
</TabItem>
86+
<TabItem label='systemd-boot (UEFI only)'>
87+
Reinstall systemd-boot with the following command:
88+
```bash
89+
sudo bootctl install
90+
```
91+
</TabItem>
92+
<TabItem label='Limine'>
93+
Reinstall Limine with the following command:
94+
<Tabs>
95+
<TabItem label='UEFI'>
96+
```bash
97+
sudo limine-install
98+
```
99+
</TabItem>
100+
<TabItem label='MBR/BIOS'>
101+
```bash
102+
sudo limine bios-install /dev/sdX # Replace sdX with your disk e.g. sda
103+
```
104+
</TabItem>
105+
</Tabs>
106+
</TabItem>
107+
<TabItem label='rEFInd (UEFI only)'>
108+
Reinstall rEFInd with the following command:
109+
```bash
110+
sudo refind-install
111+
```
112+
</TabItem>
113+
</Tabs>
114+
4. Reinstall the CachyOS kernel:
115+
```bash
116+
sudo pacman -Sy linux-cachyos linux-cachyos-headers
117+
```
118+
5. Exit from cachy-chroot:
119+
```bash
120+
exit
121+
```
122+
6. Reboot your system.
123+
</Steps>
124+
47125
## Package Management & Updates
48126

49127
### Pacman Troubleshooting

0 commit comments

Comments
 (0)