-
Notifications
You must be signed in to change notification settings - Fork 35
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Installation on Root Overhaul & Tweaks (#61)
* Overhaul & Tweaks * Uppercase fix * Fixes suggested by Naim
- Loading branch information
Showing
2 changed files
with
200 additions
and
51 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
211 changes: 189 additions & 22 deletions
211
src/content/docs/installation/installation_on_root.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,58 +1,225 @@ | ||
| --- | ||
| title: Installation on Root | ||
| title: How To Install CachyOS & Partition Guide | ||
| description: Erase Disk Installation | ||
| --- | ||
|
|
||
| import { Steps } from '@astrojs/starlight/components'; | ||
| import { Steps, Tabs, TabItem } from '@astrojs/starlight/components'; | ||
|
|
||
| :::caution | ||
| Secure boot must be disabled when installing CachyOS. To setup secure boot after install. Check [Secure Boot Setup.](/configuration/secure_boot_setup) | ||
| ::: | ||
|
|
||
| ## Erase Disk | ||
|
|
||
| CachyOS provides several ways to install the system. | ||
| The "Erase Disk" Option in Calamares will wipe the selected disk and install then CachyOS to the target. | ||
|
|
||
| <Steps> | ||
|
|
||
| 1. Boot into the ISO and click on **Launch Installer**. | ||
|
|
||
| 2. Select a **Boot Manager** that suits your preferences. Check the [Boot Managers](/installation/boot_managers) section for more information. | ||
|
|
||
| 3. Set your preferred **Language** and **Region/Timezone**. | ||
|
|
||
| 4. Configure your **Keyboard Layout**. | ||
|
|
||
| 5. Select **Erase Disk** and choose a [Filesystem](/installation/filesystem). | ||
|
|
||
| 6. Pick the **Desktop Environment** you'd like to use, see [Desktop Environments](/installation/desktop_environments). | ||
|
|
||
| 7. Select the specific packages you wish to install from the provided list, and deselect any that you do not require. | ||
|
|
||
| 8. Setup your login credentials. | ||
|
|
||
| 9. Review the installation summary on the Overview Page carefully. If all the settings look correct for you, proceed with the installation by clicking on ***Install Now***. Otherwise, go back and make any necessary changes. | ||
|
|
||
| </Steps> | ||
|
|
||
| ## Manual Partitioning | ||
|
|
||
| ### UEFI/GPT | ||
|
|
||
| Depending on what [Boot Manager](/installation/boot_managers/) you have decided to use. Please follow the instructions for each. | ||
|
|
||
| <Tabs> | ||
|
|
||
| <TabItem label='systemd-boot'> | ||
|
|
||
| <Steps> | ||
|
|
||
| 1. Boot into the ISO and click the **Launch Installer** button | ||
|
|
||
| 2. Set your preferred **Language** and **Region/Timezone**. | ||
|
|
||
| 3. Configure your **Keyboard Layout**. | ||
|
|
||
| 4. Select **Manual partitioning**. | ||
|
|
||
| 5. Create a new partition with the following: | ||
| * Size: ***2048MiB*** | ||
| * Filesystem: ***FAT32*** | ||
| * Mount point: ***/boot*** | ||
| * Flags: **boot** | ||
|
|
||
| 6. Create another partition for ***root***: | ||
| * Size: ***At least 20000MiB*** | ||
| * Filesystem: Any, refer [Filesystem](/installation/filesystem) | ||
| * Mount point: ***/*** | ||
| * Flags: | ||
|
|
||
| 7. Double check that ***Install boot loader on:*** is pointing to /boot | ||
|
|
||
| 8. Pick the **Desktop Environment** you'd like to use, see [Desktop Environments](/installation/desktop_environments). | ||
|
|
||
| 9. Select the specific packages you wish to install from the provided list, and deselect any that you do not require. | ||
|
|
||
| 10. Setup your login credentials. | ||
|
|
||
| 11. Review the installation summary on the Overview Page carefully. If all the settings look correct for you, proceed with the installation by clicking on ***Install Now***. Otherwise, go back and make any necessary changes. | ||
|
|
||
| </Steps> | ||
|
|
||
| </TabItem> | ||
|
|
||
| <TabItem label='GRUB'> | ||
|
|
||
| <Steps> | ||
|
|
||
| 1. Boot into the ISO and click the **Launch Installer** button | ||
|
|
||
| 2. Choose one among the three **boot manager** options that you are presented with. See [Boot Managers](/installation/boot_managers/) | ||
| for a brief comparison between systemd-boot, rEFInd and GRUB | ||
| 2. Set your preferred **Language** and **Region/Timezone**. | ||
|
|
||
| 3. Configure your **Keyboard Layout**. | ||
|
|
||
| 4. Select **Manual partitioning**. | ||
|
|
||
| 3. Choose your **Region** | ||
| 5. Create a new partition with the following: | ||
| * Size: ***At least 100MiB*** | ||
| * Filesystem: ***FAT32*** | ||
| * Mount point: ***/boot/efi*** | ||
| * Flags: **boot** | ||
|
|
||
| 4. Choose your **Keyboard Layout** | ||
| 6. Create another partition for ***root***: | ||
| * Size: ***At least 20000MiB*** | ||
| * Filesystem: Any, refer [Filesystem](/installation/filesystem) | ||
| * Mount point: ***/*** | ||
| * Flags: | ||
|
|
||
| 5. Choose your **filesystem**. If you are not sure which one to choose, please take a look to [Filesystems](/installation/filesystem) | ||
| 7. Double check that ***Install boot loader on:*** is pointing to /boot/efi | ||
|
|
||
| 6. Choose your **Desktop Environment** you want to use, see [Desktop environments](/installation/desktop_environments) | ||
| 8. Pick the **Desktop Environment** you'd like to use, see [Desktop Environments](/installation/desktop_environments). | ||
|
|
||
| 7. Tick or Untick further packages for the netinstallation. | ||
| 9. Select the specific packages you wish to install from the provided list, and deselect any that you do not require. | ||
|
|
||
| 8. Check the **Summary Page** and proceed with the installation. | ||
| 10. Setup your login credentials. | ||
|
|
||
| 11. Review the installation summary on the Overview Page carefully. If all the settings look correct for you, proceed with the installation by clicking ***Install Now***. Otherwise, go back and make any necessary changes. | ||
|
|
||
| </Steps> | ||
|
|
||
| </TabItem> | ||
|
|
||
| <TabItem label='rEFInd'> | ||
|
|
||
| <Steps> | ||
|
|
||
| 1. Boot into the ISO and click the **Launch Installer** button | ||
|
|
||
| 2. Set your preferred **Language** and **Region/Timezone**. | ||
|
|
||
| 3. Configure your **Keyboard Layout**. | ||
|
|
||
| 4. Select **Manual partitioning**. | ||
|
|
||
| 5. Create a new partition with the following: | ||
| * Size: ***At least 100MiB*** | ||
| * Filesystem: ***FAT32*** | ||
| * Mount point: ***/boot/efi*** | ||
| * Flags: **boot** | ||
|
|
||
| 6. Create another partition: | ||
| * Size: ***2048MiB*** | ||
| * Filesystem: ***EXT4*** | ||
| * Mount point: ***/boot*** | ||
| * Flags: | ||
|
|
||
| 7. Create another partition for ***root***: | ||
| * Size: ***At least 20000MiB*** | ||
| * Filesystem: Any, refer [Filesystem](/installation/filesystem) | ||
| * Mount point: ***/*** | ||
| * Flags: | ||
|
|
||
| 8. Double check that ***Install boot loader on:*** is pointing to /boot/efi | ||
|
|
||
| 9. Pick the **Desktop Environment** you'd like to use, see [Desktop Environments](/installation/desktop_environments). | ||
|
|
||
| 10. Select the specific packages you wish to install from the provided list, and deselect any that you do not require. | ||
|
|
||
| 11. Setup your login credentials. | ||
|
|
||
| 12. Review the installation summary on the Overview Page carefully. If all the settings look correct for you, proceed with the installation by clicking on ***Install Now***. Otherwise, go back and make any necessary changes. | ||
|
|
||
| </Steps> | ||
|
|
||
| </TabItem> | ||
|
|
||
| </Tabs> | ||
|
|
||
| ### MBR/BIOS | ||
|
|
||
| :::note | ||
| Secure boot must be disabled when installing CachyOS. To setup secure boot after install, see: [Secure Boot Setup](/configuration/secure_boot_setup) | ||
| GRUB is the only boot manager available for a MBR/BIOS system. | ||
| ::: | ||
|
|
||
| Calamares will then proceed to install CachyOS into your drive. The drivers will already be configured and working correctly out of the box with the help of our Hardware Detection. There is no need to install additional drivers after the installation unless needed for some less supported hardware. | ||
| <Steps> | ||
|
|
||
| As soon as Calamares has finished installing CachyOS, you'll get a prompt to reboot your system. | ||
| 1. Boot into the ISO and click the **Launch Installer** button | ||
|
|
||
| ### Common Issues | ||
| 2. Set your preferred **Language** and **Region/Timezone**. | ||
|
|
||
| #### Key was created in the future | ||
| 3. Configure your **Keyboard Layout**. | ||
|
|
||
| The Installation does fail with following input: | ||
| ``` | ||
| 4. Select **Manual partitioning**. | ||
|
|
||
| 5. Create a new partition with the following: | ||
| * Size: ***At least 20000MiB*** | ||
| * Filesystem: Any, refer [Filesystem](/installation/filesystem) | ||
| * Mount point: ***/*** | ||
| * Flags: | ||
|
|
||
| 6. Double check that ***Install boot loader on:*** is pointing to your boot drive e.g: /dev/sda | ||
|
|
||
| 7. Pick the **Desktop Environment** you'd like to use, see [Desktop Environments](/installation/desktop_environments). | ||
|
|
||
| 8. Select the specific packages you wish to install from the provided list, and deselect any that you do not require. | ||
|
|
||
| 9. Setup your login credentials. | ||
|
|
||
| 10. Review the installation summary on the Overview Page carefully. If all the settings look correct for you, proceed with the installation by clicking on ***Install Now***. Otherwise, go back and make any necessary changes. | ||
|
|
||
| </Steps> | ||
|
|
||
| ## Common Issues | ||
|
|
||
| ### Key was created in the future | ||
|
|
||
| :::note | ||
| This will be fixed in the September 2024 Release. | ||
| ::: | ||
|
|
||
| The Installation fails with the following error log: | ||
| ```text | ||
| gpg: key B1D99E8932D24EB5 was created 4785 seconds in the future (time warp or clock problem) | ||
| ``` | ||
|
|
||
| This indicates that the hardware clock is not correctly synced. | ||
| After the installation failed reboot into the ISO and run following commands: | ||
| This problem is caused by an out-of-sync local time. | ||
| To be specific, the pacman master key was created when a wrong time set in your OS. This may cause the timestamp of the pacman master key is in the future after you correct the time on your OS (possibly by ntp). | ||
|
|
||
| After the installation failed, reboot again to the ISO and run the following commands: | ||
|
|
||
| ```sh | ||
| sudo rm -rf /etc/pacman.d/gnupg | ||
| timedatectl set-ntp true | ||
| ``` | ||
|
|
||
| After that, click on the **Launch Installer** Button and proceed with the installation. | ||
| This will be fixed in the September 2024 Release. | ||
| Having done that, click on ***Launch Installer*** and proceed with the installation. |