From af487077fff6652bd71813dfda1fe6b251cd466b Mon Sep 17 00:00:00 2001
From: Emilia Miki <70957172+emilia-miki@users.noreply.github.com>
Date: Tue, 26 May 2026 20:45:13 +0300
Subject: [PATCH] Update faq.md: add boot loop issue

Add solution to the boot loop bug that happens when an OS is installed too many times.

Signed-off-by: Emilia Miki <70957172+emilia-miki@users.noreply.github.com>
---
 docs/project/faq.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/project/faq.md b/docs/project/faq.md
index 05277e00..2af33c6b 100644
--- a/docs/project/faq.md
+++ b/docs/project/faq.md
@@ -58,6 +58,10 @@ As the message implies, this is caused by Time Machine snapshots taking up "free
 
 Don't use Disk Utility, it's broken and only works for really simple partition setups. See [Partitioning cheatsheet](../sw/partitioning-cheatsheet.md) to learn how to manage partitions with the command line instead.
 
+## I can't install any system using the installer: device enters a boot loop and drops in Recovery OS
+
+This is most likely an Apple bug that happens when you've installed an OS too many times. See [this issue](https://github.com/AsahiLinux/asahi-installer/issues/255#issuecomment-1987050522)
+
 ## Do I need to reinstall to get new features / updates?
 
 No! Just upgrade your system using `dnf upgrade`. Kernel updates will require a reboot. Consider a tool like `needrestart` to determine if there are any outdated services or an outdated kernel running.