wiki/getstarted/disk.md

66 lines
2.7 KiB
Markdown
Raw Normal View History

2021-11-13 11:37:34 +00:00
---
title: Get started with Phyllome OS
description:
published: true
2022-07-28 01:06:39 +00:00
date: 2022-07-28T01:06:37.558Z
2021-11-13 11:37:34 +00:00
tags:
editor: markdown
dateCreated: 2021-11-13T11:37:31.498Z
---
2021-11-23 15:05:22 +00:00
# How to use Phyllome OS
2021-11-13 15:59:42 +00:00
2021-11-25 14:05:39 +00:00
*This section explains how to further configure Phyllome OS and how to use in a general sense.*
2021-11-13 15:59:42 +00:00
2022-07-28 01:06:39 +00:00
* TLDR: [Install a guest operating system](https://wiki.phyllo.me/gofurther#install-a-guest-operating-system)
2022-07-28 01:05:36 +00:00
2021-11-23 11:25:54 +00:00
## Post-installation configuration
2021-11-13 15:59:42 +00:00
2021-11-23 15:50:27 +00:00
After Phyllome OS [has been successfully installed](/deploy/install) and [its first-launch process completed](/deploy/install#first-launch), a few tasks are required before it can be used to its fullest potential.
2021-11-23 11:17:31 +00:00
2022-01-12 20:28:42 +00:00
> As Phyllome OS evolves, the following post-installation configuration will, hopefully, be made obsolete
2021-11-23 11:25:54 +00:00
{.is-info}
2021-11-13 15:59:42 +00:00
2021-12-12 17:30:53 +00:00
### Grant the current user the ability to manage system-based virtual machines
2021-11-23 13:33:28 +00:00
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.
2021-12-12 17:30:53 +00:00
To avoid a password prompt each time you connect to *qemu:///system*, you can add the current user to the `libvirt` by using the following command, in the terminal:
2021-11-23 13:33:28 +00:00
```
sudo usermod -a -G libvirt $(whoami)
```
2021-11-23 15:05:22 +00:00
> Phyllome OS will eventually switch to the *qemu:///session* URI, which doesn't require elevated privileges. Have a look at [this great blog post](https://blog.wikichoon.com/2016/01/qemusystem-vs-qemusession.html) to understand some of the differences between the *session* and the *system* URI.
{.is-info}
2021-11-26 16:02:42 +00:00
### Update GRUB and reboot
Unfortunately, the GRUB config won't correctly update during the kickstart phase, so it has to be done manually.
```
sudo grub2-mkconfig -o /boot/grub2/grub.cfg
```
When the is done, please reboot: `sudo reboot`
2022-07-28 01:05:36 +00:00
### Modify the system allocated to the GPU in the BIOS/UEFI (vfio-mdev only)
> Some computers allow you to modify the system memory allocated or shared with the integrated GPU, which may allow you to create more vGPUs.
{.is-info}
> For Intel integrated graphics cards only; rarely available on laptops computers.
{.is-warning}
* Before the host operating system boots up, you need to enter the BIOS/UEFI and to look for a setting called *GPU aperture size*, or *GPU shared memory*.
2021-11-25 14:05:39 +00:00
2022-07-28 01:05:36 +00:00
* Use the highest possible value.
2021-11-23 10:47:09 +00:00
2022-07-28 01:05:36 +00:00
> System memory will be reserved for the GPU, so make sure you have enough system memory to accomodate both the GPU and your operating system.
2021-11-25 14:44:34 +00:00
{.is-warning}
2022-07-28 01:05:36 +00:00
2021-11-13 15:59:42 +00:00
---
2021-11-23 13:16:44 +00:00
*Are you looking for tasks to do with your system? If so, have a look at doing some [suggested tasks](/gofurther)*
2021-11-13 15:59:42 +00:00
[^1]: Although, we very much encourage you to [hack it](https://github.com/PhyllomeOS/phyllomeos#how-to-hack-phyllome-os).