[pve-devel] [PATCH pve-docs v3 1/1] installation: remove maxroot size requirement and mention default instead

[Michael Köppl]

The requirement of hdsize/4 was not checked anywhere and adding sanity
checks for maxroot<=hdsize/4 would stop users from installing PVE on
smaller disks (see [0]), whereas the installation actually tries its
best to successfully install even on disks below 12GB. So instead of
adding sanity checks, relax the documentation regarding this requirement
and instead refer to the defaults used during installation to provide
guidance for users.

[0] https://lore.proxmox.com/pve-devel/D9P1YXB42LGJ.ULII1HUIPAWQ@proxmox.com/

Signed-off-by: Michael Köppl <m.koeppl at proxmox.com>
---
The default size is not exact. The size of the root volume also depends
on the swap size and the installer will then add 12GiB to (os_size -
swap_size)/4. Was not entirely sure how to best describe this here
without going into too much technical details for users and without
making this part of the docs too confusing. The idea behind the
description in this patch was to give users some orientation in case
they want to choose the root size themselves. Feedback very much
appreciated.

 pve-installation.adoc | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/pve-installation.adoc b/pve-installation.adoc
index 223bb716..30ad6b81 100644
--- a/pve-installation.adoc
+++ b/pve-installation.adoc
@@ -281,7 +281,9 @@ NOTE: If set to `0`, no `swap` volume will be created.
 `maxroot`::
 
 Defines the maximum size of the `root` volume, which stores the operation
-system. The maximum limit of the `root` volume size is `hdsize/4`.
+system. With more than 48GiB storage available, the default is `hdsize/4`
+with a maximum of 96 GiB. Below 48GiB, the `root` volume size is at least
+`hdsize/2`.
 
 `maxvz`::
 
-- 
2.39.5