4.3 KiB
| title | description | published | date | tags | editor | dateCreated |
|---|---|---|---|---|---|---|
| Get started with Phyllome OS | true | 2021-11-23T15:23:11.524Z | 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 the first-launch process has been 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 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
That's it, congratulations! {.is-success}
Are you looking for tasks to do with your system? If so, have a look at doing some suggested tasks