roots/wiki

mirror of https://github.com/PhyllomeOS/wiki.git synced 2024-11-05 19:51:26 +00:00

lukas b8826a0e6f docs: update getstarted/disk

2021-11-23 15:50:27 +00:00

5.1 KiB

Raw Blame History

title	description	published	date	tags	editor	dateCreated
Get started with Phyllome OS		true	2021-11-23T15:50:24.887Z		markdown	2021-11-13T11:37:31.498Z

How to use Phyllome OS

This section explains how to further configure Phyllome OS, and how to deploy your favorite operating system within it.

Post-installation configuration

After Phyllome OS has been successfully installed and its first-launch process completed, a few tasks are required before it can be used to its fullest potential.

As Phyllome OS evolves, one of the main goal is to shorten the time it would take for an end-user to have a fully operational virtual machine loaded with the installer of their favorite operating system, to the point that a user may not see the Phyllome OS environnement at all. {.is-info}

The following post-instalaltion configuration will, hopefully, be made obsolete in a future Phyllome OS version. {.is-info}

Grant the current user the ability to manage virtual machines

Any new user, including the one that has been created during the first-launch set up, won't be part of the libvirt group. It means that it won't be able to manage the qemu:///system, which runs libvirt as root.

To avoid a password prompt each time the Virtual Machine Manager is launched, you can add the current user to the libvirt by using the following command, in the terminal:

sudo usermod -a -G libvirt $(whoami)

A known bug affects the terminal: extra spaces between letters. To solve it, click on the burger menu (the three stacked horizontal lines) then go to Preferences > Profiles > Unnamed and check the box called Custom font. {.is-warning}

Phyllome OS will eventually switch to the qemu:///session URI, which doesn't require elevated privileges. Have a look at this great blog post to understand some of the differences between the session and the system URI.
{.is-info}

Run a few scripts

During the installation process, a few scripts are fetched and stored under the /usr/sbin directory. They need to be run to further customize Phyllome OS.

Desktop enhancements

The following script will change the desktop background and pick opinionated defaults for the Virtual Machine Manager. It will also add a new User session URI for the Virtual Machine Manager.

Open the terminal and run the following script as a regular user:

/usr/sbin/configure-vmm-and-desktop.sh

The updated desktop background. Notice that there is now a new URI called QEMU/KVM User session

Create and run a virtual machine without any attached disk

The following script, which also doesn't require root privileges, will create a virtual machine called my-first-live-vm. This virtual machine will be started automatically and added to virt-manager.

/usr/sbin/create-live-vm.sh

Notice the new icon under QEMU/KVM: this is the new virtual machine that has just been created. Go to the section to learn how to interact with it.

Access your virtual machine display

Double-click on my-first-live-vm to open its virtual display, then click on Connect to console.

Phyllome OS ships with a small ISO crafted by the team behind netboot.xyz, and that can do network boot, allowing it to do network-based installations of the most popular Linux distributions, among other niceties. {.is-info}