wiki/deploy/install.md

106 lines
4.2 KiB
Markdown
Raw Normal View History

2021-11-14 16:19:03 +00:00
---
title: Install Phyllome OS
description:
published: true
2021-11-22 21:00:04 +00:00
date: 2021-11-22T21:00:02.195Z
2021-11-14 16:19:03 +00:00
tags:
editor: markdown
dateCreated: 2021-11-14T16:19:00.348Z
---
2021-11-22 16:11:39 +00:00
# How to install Phyllome OS
2021-11-22 20:35:23 +00:00
> As of now, it is only possible to deploy Phyllome OS using an [**offical Fedora ISO file**](https://getfedora.org/en/server/). It you don't have a USB flash drive ready to use, please go back to the last section.
2021-11-22 16:11:39 +00:00
{.is-info}
2021-11-22 20:50:20 +00:00
*This page is intended for users that would like to install Phyllome OS permanently on their computer. Installing Phyllome OS means booting from a USB flash drive and fetching an online file that contains instructions to automatically deploy it on a target storage device. This is a destructive process so please be cautious*
2021-11-22 16:11:39 +00:00
## Boot from a USB flash drive
The following section illustrates how to change the boot order *temporarily*. The process to change the boot order depends on your current computer platform. Please follow the instruction that matches your platform.
### macOS
* Make sure that your computer is turned-off.
* Plug the USB flash drive loaded with the official Fedora ISO.
* Locate the <kbd>Alt</kbd> / <kbd>Option</kbd> key on your keyboard.
* Turn your computer on and immediately press the <kbd>Alt</kbd> / <kbd>Option</kbd> key continuously.
* The startup manager should appear after a few seconds.
* Click on the option called *EFI* and the GRUB splash screen will appear. Go to the section below to learn what to do next.
![screenshot_uefi_2021-11-22_154211.png](/grub-kickstart/screenshot_uefi_2021-11-22_154211.png)
### Windows 8 and later versions
> Section under construction
{.is-warning}
2021-11-22 14:29:07 +00:00
2021-11-22 16:11:39 +00:00
### Other computers
> Section under construction
{.is-warning}
## Alter the GRUB instructions
2021-11-22 14:29:07 +00:00
2021-11-22 16:11:39 +00:00
> GRUB is universal bootloader that ship with many Linux distributions. It is a software made to find and load operating systems during a boot process.
2021-11-22 14:29:07 +00:00
{.is-info}
2021-11-22 16:11:39 +00:00
One needs to alter the GRUB instructions before the USB flash drive can load the Anaconda Installer, which is normally used to install Fedora and other related distributions. If Fedora is already installed on your computer, and if your GRUB is not password protected, which is the default behavior, you may also be able to follow the instructions below.
### EFI-based firmware
2021-11-22 16:35:49 +00:00
* On the GRUB splash screen, navigate to the first entry using your keyboard arrow key and press <kbd>e</kbd>.
2021-11-22 16:11:39 +00:00
![screenshot_uefi_2021-11-22_154226.png](/grub-kickstart/screenshot_uefi_2021-11-22_154226.png)
2021-11-22 16:35:49 +00:00
* On the new screen, navigate after the *quiet* word.
2021-11-22 16:11:39 +00:00
![screenshot_uefi_2021-11-22_154238.png](/grub-kickstart/screenshot_uefi_2021-11-22_154238.png)
2021-11-22 16:35:49 +00:00
> GRUB defaults to the US keyboard layout. Have a look at [this online ressource](https://en.wikipedia.org/wiki/QWERTY#/media/File:KB_United_States.svg) to find the corresponding keys if you are having a hard time finding the right keystroke
2021-11-22 16:11:39 +00:00
{.is-info}
2021-11-22 16:35:49 +00:00
> **Danger Zone**: the next instruction will trigger an automated process that will **destroy** any data located on the internal disk in your computer.
2021-11-22 16:11:39 +00:00
{.is-danger}
2021-11-22 16:35:49 +00:00
* Leave a blank space after the `quiet` word and write exactly the following `inst.ks=https://ks.phyllo.me/dii`, then press <kbd>Ctrl</kbd> + <kbd>x</kbd> simultaneously.
2021-11-22 16:11:39 +00:00
![screenshot_uefi_2021-11-22_155450.png](/grub-kickstart/screenshot_uefi_2021-11-22_155450.png)
2021-11-22 16:35:49 +00:00
* The command will trigger the automated installation of Phyllome OS.
2021-11-22 16:11:39 +00:00
2021-11-22 16:45:31 +00:00
> The shortened URL `https://ks.phyllo.me/dii` points to the latest Desktop version of Phyllome OS, tweaked for Intel CPUs and GPUs. The kickstart file is available here: https://raw.githubusercontent.com/PhyllomeOS/phyllomeos/main/leaves/flat-dhi.cfg
{.is-info}
2021-11-22 16:11:39 +00:00
2021-11-22 16:35:49 +00:00
![screenshot_uefi_2021-11-11_130934.png](/grub-kickstart/screenshot_uefi_2021-11-11_130934.png)
After a few minutes, you should be greeted with a welcome screen.
![screenshot_uefi_2021-11-11_143000.png](/grub-kickstart/screenshot_uefi_2021-11-11_143000.png)
2021-11-22 16:11:39 +00:00
2021-11-22 16:44:15 +00:00
Go to the [First-launch configuration section](/deploy/install#first-launch) to learn what to do next.
2021-11-22 16:11:39 +00:00
### BIOS-based firmware
2021-11-22 16:43:58 +00:00
> Section under construction
{.is-warning}
2021-11-22 16:44:07 +00:00
## First-launch
2021-11-22 16:43:58 +00:00
2021-11-22 16:45:31 +00:00
> Section under construction
{.is-warning}
2021-11-22 16:43:58 +00:00
2021-11-22 16:35:49 +00:00
---
2021-11-22 16:11:39 +00:00
2021-11-22 16:35:49 +00:00
*Please go to the [Get Started section](https://wiki.phyllo.me/getstarted/disk) to learn what to do next.*
2021-11-22 16:11:39 +00:00
2021-11-22 14:29:07 +00:00