wiki/deploy/medium.md

137 lines
6.1 KiB
Markdown
Raw Normal View History

2021-11-21 11:33:38 +00:00
---
2021-11-21 12:11:51 +00:00
title: Phyllome OS meets a thumb drive
2021-11-21 11:33:38 +00:00
description:
published: true
2021-11-21 17:52:23 +00:00
date: 2021-11-21T17:52:21.017Z
2021-11-12 15:17:36 +00:00
tags:
editor: markdown
2021-11-13 11:34:11 +00:00
dateCreated: 2021-11-13T11:34:07.852Z
2021-11-12 15:17:36 +00:00
---
2021-11-13 13:41:55 +00:00
# Create an installation medium
2021-11-21 16:34:47 +00:00
*In this section, you will learn how to download Phyllome OS and how to create a live medium that will allow you to boot it from a USB flash drive.*
2021-11-13 13:41:55 +00:00
2021-11-21 13:43:33 +00:00
## 1. Download Phyllome OS
2021-11-21 11:46:39 +00:00
The Phyllome OS ISOs files are made available [on GitHub](https://github.com/PhyllomeOS/phyllomeos/releases).
2021-11-21 16:34:47 +00:00
As of now, only the *Phyllome OS Desktop II edition* is available as an ISO file. The *II edition* is tuned for Intel CPUs and Intel GPUs. It is also known as *ldhi*, for *live*, *desktop*, *hypervisor*, and *intel*.
2021-11-21 17:52:23 +00:00
> If you intent to install Phyllome OS permanently on your computer, use a [Fedora Server ISO instead](https://getfedora.org/en/server/), as it is not yet possible to install Phyllome OS from the live image. The steps below are made to be generic, and should be valid regardless of the ISO you use
{.is-info}
2021-11-21 11:46:39 +00:00
* [**The direct link**](https://github.com/PhyllomeOS/phyllomeos/releases/download/v.0.2.0-alpha/phyllome-live_ldhi_v0.2.0-alpha_x86_64.iso) to download the ISO. It will take some time to load.
2021-11-21 13:50:56 +00:00
> As of now, there is no checksum available, and the release is not signed using GPG keys. Among other things, it means that there is no guarantee about the authenticity of the file or its integrity, whatsoever. Alternatively, a safer is to deploy Phyllome OS [in a virtual machine](https://github.com/PhyllomeOS/phyllomeos#how-to-hack-phyllome-os) or to deploy it directly on a host using [this method](/deploy/live)
2021-11-21 11:46:39 +00:00
{.is-warning}
2021-11-21 13:43:33 +00:00
## 2. Load Phyllome OS on a USB flash drive
2021-11-21 11:46:39 +00:00
The following instructions may have to be adapted depending on the operating system that you are currently using.
* *General requirements*
2021-11-21 12:06:22 +00:00
* A fast USB 3.0 flash drive of at least 2 GB
2021-11-21 11:46:39 +00:00
2021-11-21 13:44:17 +00:00
### Command-line instructions (Linux-only): flash a USB disk using the `dd` command line tool
2021-11-21 11:46:39 +00:00
The next command assumes that the ISO file is available in the *Downloads* folder and that the target medium is called `sdz`. You can identify the correct target device using the `lsblk` command line tool. Modify the command according to your context.
> This command requires root privileges
{.is-info}
2021-11-21 16:00:47 +00:00
> **Warning:** This command will **destroy** any data on the target device
2021-11-21 12:11:51 +00:00
{.is-danger}
2021-11-21 12:06:22 +00:00
2021-11-21 11:46:39 +00:00
```
dd bs=4MB if=~/Downloads/phyllome-live_ldhi_v0.2.0-alpha_x86_64.iso of=/dev/sdz
```
### Manual instructions: flash a USB disk using Etcher
2021-11-21 12:06:22 +00:00
The instructions are designed with Etcher in mind. Other tools such as [Rufus](https://rufus.ie/en/), [Unetbootin](https://unetbootin.github.io/) or [Ventoy](https://www.ventoy.net/en/index.html) are likely to work too.
2021-11-21 11:46:39 +00:00
2021-11-21 13:50:56 +00:00
> Etcher is an open-source, cross platform tool for flashing images to a target medium. It is developed and made available by [balena](https://www.balena.io/).
2021-11-21 11:46:39 +00:00
{.is-info}
2021-11-21 16:00:47 +00:00
#### Install Etcher
2021-11-21 11:46:39 +00:00
You can download Etcher on [the official website](https://www.balena.io/etcher/).
2021-11-13 13:46:55 +00:00
2021-11-21 11:46:39 +00:00
Pick the right version depending on your platform.
2021-11-13 13:41:55 +00:00
2021-11-21 11:46:39 +00:00
Follow the normal procedure to install an application on your computer.
2021-11-13 13:41:55 +00:00
2021-11-21 11:46:39 +00:00
> An account with administrator rights will be needed.
{.is-info}
2021-11-13 13:46:55 +00:00
2021-11-21 16:00:47 +00:00
#### Use it
2021-11-13 13:41:55 +00:00
2021-11-21 16:00:47 +00:00
* Insert a blank flash drive on a free USB slot on your computer
2021-11-21 12:14:32 +00:00
2021-11-21 16:34:47 +00:00
* Open Etcher. You will be greeted by the screen below. Click on *Flash from file*
2021-11-21 12:06:22 +00:00
![capture-balenaetcher-1.png](/balena-etcher/capture-balenaetcher-1.png)
2021-11-21 16:00:47 +00:00
* Browse where the ISO is stored and select *Open*
2021-11-21 12:06:22 +00:00
![capture-balenaetcher-2.png](/balena-etcher/capture-balenaetcher-2.png)
2021-11-21 16:00:47 +00:00
* Etcher should have autodetected your USB flash drive. If this is not the case, press *Change* on the welcome screen and pick the desired destination on the new window.
2021-11-21 12:06:22 +00:00
![capture-balenaetcher-3.png](/balena-etcher/capture-balenaetcher-3.png)
2021-11-21 16:00:47 +00:00
* Select *Flash* when you are ready
2021-11-21 12:06:22 +00:00
2021-11-21 16:00:47 +00:00
> **Warning:** clicking *Flash* will **destroy** any data on the target device
2021-11-21 12:11:51 +00:00
{.is-danger}
2021-11-21 12:06:22 +00:00
2021-11-21 16:34:47 +00:00
> A prompt might appear, asking for your password or a confirmation
2021-11-21 16:00:47 +00:00
{.is-info}
2021-11-21 12:06:22 +00:00
![capture-balenaetcher-4.png](/balena-etcher/capture-balenaetcher-4.png)
2021-11-21 16:00:47 +00:00
* Wait a few minutes...
2021-11-21 12:06:22 +00:00
![capture-balenaetcher-5.png](/balena-etcher/capture-balenaetcher-5.png)
> Congratulations, the USB flash drive is now ready to use!
{.is-success}
![capture-balenaetcher-6.png](/balena-etcher/capture-balenaetcher-6.png)
2021-11-21 13:54:22 +00:00
## 3. Boot from a USB flash drive
2021-11-21 16:40:21 +00:00
By default, when a computer boots up, it will look for an operating system on the internal storage device first. If there is one, it will load this operating system and ignore any other media, such as any USB flash drive that may be plugged to the computer.
2021-11-21 16:34:47 +00:00
To boot from a USB flash drive, one would have to either temporary or permanently alter the so-called boot order. The boot order instructs at what point and where it should look for an operating system. The following section illustrates how to change the boot order *temporary*.
> The process to change the boot order depends on your current computer platform. Please follow the instruction that matches your platform.
{.is-info}
2021-11-21 16:40:21 +00:00
> Booting from a USB flash drive is a **non-destructive** process, which means that it won't affect any pre-existing operating system that may be installed on your computer. As a precautious, it may be good to backup your data or, even better, to use a computer with no personnal data on it.
2021-11-21 16:34:47 +00:00
{.is-info}
2021-11-21 16:00:47 +00:00
### macOS
2021-11-21 16:40:21 +00:00
* Make sure that your computer is turned-off.
2021-11-21 16:50:01 +00:00
* 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* to boot Phyllome OS.
2021-11-21 16:34:47 +00:00
2021-11-21 16:50:01 +00:00
> Other Mac startup key combinations can be found [here](https://support.apple.com/en-us/HT201255).
{.is-info}
2021-11-21 16:34:47 +00:00
2021-11-21 17:15:58 +00:00
### Windows 8 and later versions
### Other computers
2021-11-21 16:34:47 +00:00
2021-11-21 13:54:22 +00:00
2021-11-13 13:45:13 +00:00
---
2021-11-21 16:38:27 +00:00
*If you have followed the procedure using the Phyllome OS ISO, go to the section [Get started with the live system](/getstarted/live).*
*If you have followed the procedure using the Fedora Server ISO, with the intent of installing Phyllome OS permanently, please go to the [Install Phyllome OS page](https://wiki.phyllo.me/deploy/install) instead.*