Skip to content

Commit 60d64dd

Browse files
authored
Overhauled the Boot Rescue section (#616)
- Split the original file into multiple individual guides - Re-write the guides using the new style guide The purpose of this re-organization is: - Make the guides easier to read and follow - Make it easier to find the solution to a problem
1 parent 012c921 commit 60d64dd

File tree

10 files changed

+488
-259
lines changed

10 files changed

+488
-259
lines changed

docs/user/troubleshooting/boot-rescue.md

Lines changed: 0 additions & 215 deletions
This file was deleted.
Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
title: I see an emergency shell or error message during startup
3+
summary: Troubleshooting the boot process for Solus
4+
---
5+
6+
import BootAndChroot from "./snippets/_mount_partitions.mdx";
7+
import UnmountAll from "./snippets/_unmount_partitions.mdx";
8+
import WhatToDoNext from "./snippets/_contact_team.mdx";
9+
10+
## Cause
11+
12+
This issue might happen when the `/etc/fstab` file contains an entry for a storage device that isn't available during system startup, for example, disconnected USB drives or unavailable network file system (NFS) mounts.
13+
14+
When trying to mount the device, the system fails and displays an emergency shell or error message.
15+
16+
## Before your start
17+
18+
For this procedure, you need:
19+
20+
- [A Solus live USB](../../quick-start/installation/#creating-bootable-media)
21+
- Your disk encryption password, if your system is encrypted
22+
23+
## Procedure
24+
25+
1. Shut down your system.
26+
1. Boot from a Solus live USB.
27+
1. Mount the partitions of your Solus system.
28+
29+
<details>
30+
<BootAndChroot />
31+
</details>
32+
33+
1. Prevent the system from trying to mount unavailable devices.
34+
35+
<details>
36+
1. Edit `/etc/fstab` using `nano`:
37+
```bash
38+
nano /etc/fstab
39+
```
40+
2. Find all the unavailable devices.
41+
3. Add the `noauto` option to the line corresponding to the unavailable device.
42+
43+
For example:
44+
45+
```bash
46+
UUID=XXXXXX /mnt/mydisk exfat noauto,uid=1000,gid=1000,umask=0022 0 0
47+
```
48+
4. Save the file and restart your system.
49+
50+
</details>
51+
52+
1. Unmount all the Solus partitions.
53+
<details>
54+
<UnmountAll />
55+
</details>
56+
57+
## What to do next
58+
59+
<WhatToDoNext />
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
---
2+
title: Boot Rescue
3+
summary: Troubleshooting the boot process for Solus
4+
---
5+
6+
# Boot Rescue
7+
8+
When your Solus system fails to start up, several common issues might be the cause:
9+
10+
- On computers with multiple operating systems, another operating system controlling the startup sequence might not show Solus after a system update
11+
- System updates (particularly kernel updates) that didn't complete properly on either legacy BIOS or UEFI systems
12+
- Hardware changes such as adding or removing disks, or changes to disk identifiers (UUIDs) or mount points
13+
14+
This guide helps you diagnose your specific startup issue and provides instructions to restore access to your Solus system.
15+
16+
## Quick diagnosis
17+
18+
Identify your issue by selecting the scenario that matches your situation:
19+
20+
- [Solus does not appear in the startup menu](./solus-not-in-boot-menu.md)
21+
- [I see an emergency shell or error message during startup](./emergency-shell-startup.mdx)
22+
- [My system won't boot after an update](./system-not-working-after-update.mdx)
23+
- [I changed hardware and now my system won't boot](./system-not-working-hardware-change.mdx)
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
Restart your system and verify if the problem persists.
2+
3+
If you are still unable to access your Solus system after following this guide, [contact us through any of the support channels](../../../user/intro/#support-channels).

0 commit comments

Comments
 (0)