Troubleshooting System Installation Issues
Due to the complexity of devices and environments, you may encounter failures when installing FygoOS. Below are common issues and their solutions:
-
Installation succeeds, but no boot after restart
Please disable Secure Boot. Refer to "1. How to Disable Secure Boot?" below. If the installation and runtime are on different machines, ensure both use the same boot mode (both UEFI or both BIOS).
-
Installation succeeds, but kernel hangs on a black screen with white text after restart
This is most likely caused by hardware that is too old or too new, resulting in missing firmware when loading drivers.
-
No boot during installation
Check that the bootable USB drive was created correctly and that the BIOS is set to boot from the USB drive.
-
Installation stalls, or shows Grub installation failure or Mount Envi installation failure
Try restarting the machine and reinstalling a few times. If the issue persists, it may be a motherboard or hard drive problem.
-
Installation boot hangs on a black screen with white text, showing Start Init or Preparing device environment
Try restarting and selecting Rescuing Install mode from the Grub menu. Refer to "2. How to Use Rescuing Install Mode?" below.
If you encounter other issues, feel free to join the user community for feedback and discussion.
1. How to Disable Secure Boot?
Different motherboard BIOS menus vary, but the Secure Boot option is generally found under the Security menu. Below are instructions for some common motherboard brands.
1.1 Lenovo
1.2 Dell New Laptops
Press F2 to enter BIOS settings.
1.3 HP New Laptops
On HP laptops, press F10 repeatedly during startup to enter BIOS. Go to Advanced > Boot Options.
The Secure Boot option is usually located under this menu.
To enable Secure Boot, select the Secure Boot checkbox.
To disable Secure Boot, clear the Secure Boot checkbox and also select Clear Secure Boot Keys.
1.4 ASUS New Motherboards
- After powering on, immediately press the Delete key to enter BIOS Advanced Mode.
- Open the Boot page.
- Select Secure Boot.
- The OS Type option is set to Other OS by default.
- Other OS: Secure Boot is disabled.
- Windows UEFI mode: Secure Boot is enabled.
- The actual Secure Boot status depends on the BIOS settings and Secure Boot keys.
- BIOS Secure Boot State is usually read-only and cannot be changed manually. Its value depends on whether Secure Boot keys are installed.
- User means Secure Boot keys are installed.
- Setup means Secure Boot keys are not installed.
- When Secure Boot Mode is set to Standard, the Key Management option is unavailable.
| BIOS Secure Boot | OS Type | Boot Mode | Key Management | System Secure Boot |
|---|---|---|---|---|
| User | Other OS | Customer | Default | Disabled |
| User | Other OS | Standard | N/A | Disabled |
| Setup | Other OS | Customer | Clear Secure Boot Keys | Disabled |
| Setup | Windows UEFI mode | Customer | Clear Secure Boot Keys | Disabled |
| User | Windows UEFI mode | Customer | Default | Enabled |
| User | Windows UEFI mode | Standard | N/A | Enabled |
1.5 Gigabyte New Motherboards
Find the Secure Boot option under the "BIOS" menu tab in the BIOS.
Set CSM Support to Disabled, then set Secure Boot to Disabled. Save the BIOS settings and restart the device before installing FygoOS.
1.6 Colorful New Motherboards
In the BIOS, set Secure Boot to Disabled. If the motherboard provides Secure Boot mode or key management options, switch the mode to User and restore or install the default factory keys when required by the BIOS.
1.7 MSI New Motherboards
In the BIOS, find the Secure Boot option and set Secure Boot to Disabled. Save the settings and restart the device before installing FygoOS.
2. How to Use Rescuing Install Mode?
- Restart the device and quickly press the keyboard hotkey during boot to enter the boot device selection screen. Select the bootable drive and press Enter.
- Select Rescuing Install (emergency installation mode) and press Enter.
Note: For compatibility reasons, Rescuing Install mode currently uses MBR partition format. This format does not support hard drives larger than approximately 2 TB as the system drive. If the selected system drive is too large, the installation will show a "Failed to create partition" error. In this case, switch the boot mode to UEFI in the BIOS.
- The default language is English. Press Enter to confirm.
- Use the arrow keys to select the hard drive for system installation.
- The selected system drive will be formatted and all data will be deleted. Press Enter to confirm and start the installation.
- When you see the message "install trim ok!", the installation is complete. Press Enter to confirm.
- Type reboot and press Enter to restart the device. You can now remove the bootable drive from the machine.
- After the device restarts successfully, it will automatically enter the terminal login page, which means the system has been installed and started successfully. Note the IP address displayed — you will use it to access FygoOS through a web browser. You can now disconnect the monitor, keyboard, and mouse from the machine.
