roots/wiki
1
0
Fork 0
Code Pull Requests Activity

docs: update deploy/install

Browse Source
This commit is contained in:
lukas 2025-04-18 22:44:05 +00:00
parent 3e619cfcec
commit 8404a5df3a
1 changed files with 10 additions and 55 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

65
deploy/install.md
View File

@ -2,7 +2,7 @@
title: Install Phyllome OS title: Install Phyllome OS
description: description:
published: true published: true
date: 2025-04-18T14:03:59.311Z date: 2025-04-18T22:44:03.271Z
tags: tags:
editor: markdown editor: markdown
dateCreated: 2021-11-14T16:19:00.348Z dateCreated: 2021-11-14T16:19:00.348Z
@ -10,6 +10,9 @@ dateCreated: 2021-11-14T16:19:00.348Z
# Install Phyllome OS # Install Phyllome OS
> Phyllome[^1] OS is an operating system that makes it easier to run [various operating systems](#go-further) locally using [off-the-shelf hardware](/deploy/prepare) and [virtualization](/virt/lexicon#virtualization) software.
{.is-info}
[^1]: According to [the Wiktionary](https://en.wiktionary.org/wiki/phyllome), Phyllome refers to the "foliar part of a plant; any organ homologous with a leaf, or [any organ] produced by metamorphosis of a leaf" [^1]: According to [the Wiktionary](https://en.wiktionary.org/wiki/phyllome), Phyllome refers to the "foliar part of a plant; any organ homologous with a leaf, or [any organ] produced by metamorphosis of a leaf"
*This page is intended for users that would like to install Phyllome OS permanently on a computer. Make sure you understand what [Phyllome OS](/phyllomeos/purpose.md) is about before installing it* *This page is intended for users that would like to install Phyllome OS permanently on a computer. Make sure you understand what [Phyllome OS](/phyllomeos/purpose.md) is about before installing it*
@ -27,8 +30,6 @@ Installing Phyllome OS involves booting from a [bootable USB flash drive](/deplo
## Pick your flavor ## Pick your flavor
Phyllome[^1] OS is an operating system that makes it easier to run [various operating systems](#go-further) locally using [off-the-shelf hardware](/deploy/prepare) and [virtualization](/virt/lexicon#virtualization) software.
### Main flavors ### Main flavors
Phyllome OS comes in many flavors. Pick your flavor based on the hardware you wish to deploy Phyllome on. Phyllome OS comes in many flavors. Pick your flavor based on the hardware you wish to deploy Phyllome on.
@ -38,9 +39,12 @@ The shortened URL points to the full description of the edition in a kickstart f
| Edition | Shorthand | Features | Shortened URL | | Edition | Shorthand | Features | Shortened URL |
|---|---|---|---| |---|---|---|---|
| **Phyllome OS Desktop Edition** | *PODE* | Default edition. Compatible with x86-64 CPU. GPU agnostic. IOMMU support for AMD CPUs | ks.phyllo.me/d | | **Phyllome OS Desktop Edition** | *PODE* | Default edition. Compatible with x86-64 CPU. GPU agnostic. IOMMU support for AMD CPUs | ks.phyllo.me/d |
| **Phyllome OS Desktop Edition for Intel:tm: CPUs** | *PODEIC* | IOMMU and nested virtualization for Intel CPUs | ks.phyllo.me/di | | **Phyllome OS Desktop Edition for Intel:tm: CPUs** | *PODE-IC* | IOMMU and nested virtualization for Intel CPUs | ks.phyllo.me/di |
| **Phyllome OS Desktop Edition for Intel:tm: CPUs and GPUs** | *PODEICG* | IOMMU and nested virtualization on Intel CPUs & Intel GVT-g for Intel GPUs (from 5th to 9th gen *only*) | ks.phyllo.me/dii | | **Phyllome OS Desktop Edition for Intel:tm: CPUs and GPUs** | *PODE-ICG* | IOMMU and nested virtualization on Intel CPUs & Intel GVT-g for Intel GPUs (from 5th to 9th gen *only*) | ks.phyllo.me/dii |
| **Phyllome OS Desktop Edition for AMD:tm: CPUs** | PODEAC | IOMMU and nested virtualization on AMD CPUs | ks.phyllo.me/da | | **Phyllome OS Desktop Edition for AMD:tm: CPUs** | PODE-AC | IOMMU and nested virtualization on AMD CPUs | ks.phyllo.me/da |
> If you wish to learn more about how kickstart files are used to create Phyllome OS, please have a look at [the official git repository](https://git.phyllo.me/roots/phyllomeos).
{.is-info}
## Boot from the USB flash drive ## Boot from the USB flash drive
@ -90,55 +94,6 @@ One needs to alter the GRUB instructions in order to trigger the automated insta
* After a few minutes, the computer will power off * After a few minutes, the computer will power off
you should be greeted with a welcome screen.
![kickstart-5](/assets/grub-kickstart/kickstart-6.png)
> If you wish to learn more about how kickstart files are used to create Phyllome OS, please have a look at [the official git repository](https://github.com/PhyllomeOS/phyllomeos).
{.is-info}
## First-launch
* **Welcome screen**: on first-launch, for the *Desktop edition*, you will be greeted with the GNOME Welcome Screen. As of now, only English is available out of the box. Click *Next* when you are ready.
![first-launch-1.png](/assets/first-launch/first-launch-1.png)
* **Keyboard layout**: you can select your favorite keyboard layout by clicking on the three stacked vertical dots at the bottom of the screen.
> By default, Phyllome OS is set to use the *fr-CH* keyboard layout. This keyboard layout is used by people living in [Romandy](https://en.wikipedia.org/wiki/Romandy), Switzerland, which is also where the original author of Phyllome OS is from.
{.is-info}
![first-launch-2.png](/assets/first-launch/first-launch-2.png)
* **Time zone**: you can pick your current location by clicking on the map or writing it down inside the box. The time will be adjusted according to the provided location.
![first-launch-3.png](/assets/first-launch/first-launch-3.png)
* **Online Accounts**: Phyllome OS strongly discourages the use of *Online Accounts*, and therefore provides no option here. Click on *Skip* to go to the next screen.
![first-launch-4.png](/assets/first-launch/first-launch-4.png)
* **Create a user account**: you are invited to create a user account, which by default will be granted administrator or root privileges. Click on *Next* when you are done.
![first-launch-5.png](/assets/first-launch/first-launch-5.png)
* **Provide a password**: please do provide a strong password. In case you ever forget it, write it down on a piece of paper and store it somewhere safe, or/and rely on an online password manager like [Bitwarden](https://bitwarden.com/). Click on *Next* when you are done.
![first-launch-6.png](/assets/first-launch/first-launch-6.png)
* **Setup complete**: Click on start *Start Using Generic*.
![first-launch-7.png](/assets/first-launch/first-launch-7.png)
* **Provide password**: The Virtual Machine Manager is set to auto-launch, and requires elevated permission. Please provide the user password you just set up and click on *Authenticate* to start using Phyllome OS.
![first-launch-9.png](/assets/first-launch/first-launch-9.png)
> Congratulations, you are done!
{.is-success}
![first-launch-10.png](/assets/first-launch/first-launch-10.png)
> Don't forget to remove the USB flash drive from your computer, so that next time your computer will boot, it will use the internal disk where Phyllome OS has been deployed > Don't forget to remove the USB flash drive from your computer, so that next time your computer will boot, it will use the internal disk where Phyllome OS has been deployed
{.is-info} {.is-info}