From fff2bdaa8833e59d99ba04b7764915a8d5304de3 Mon Sep 17 00:00:00 2001 From: Tom Elliott Date: Wed, 2 Sep 2026 15:08:08 -0500 Subject: [PATCH] Document largesize, smallsize and USB deprioritization for disk selection fos #175 adds smallsize=1 alongside the existing, undocumented largesize=1 (fogproject #817), and fos #176 stops USB and removable devices being chosen automatically while an internal disk exists (fogproject #778). Neither the kernel arguments nor the primary disk matching rules were documented. Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_0131h4axUaE3VJZphvKRdDby --- docs/1.6/management/web/hosts.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/1.6/management/web/hosts.md b/docs/1.6/management/web/hosts.md index 24dd65e..1709af4 100644 --- a/docs/1.6/management/web/hosts.md +++ b/docs/1.6/management/web/hosts.md @@ -176,11 +176,29 @@ Hosts can also include, but are not required: > This allows you to add additional kernel arguments for booting the > host (ie: vga=6, or irqpoll). +> +> Two arguments change which disk FOG images when **Primary Disk** is +> empty and the image is a single-disk type: +> +> - `largesize=1` picks the largest disk by capacity. +> - `smallsize=1` picks the smallest disk by capacity. +> +> Without either, FOG takes the first disk the kernel enumerates. USB and +> removable devices are only considered when no internal disk is present, +> so a USB stick or a USB device that exposes its driver files as a small +> disk is never chosen over an internal drive. Both arguments can be set +> on a group to apply to every host in it. ##### Primary Disk > This option allows you to force a device to use during imaging if fog > fails to detect the correct device node. +> +> The value can be a device path such as `/dev/nvme0n1`, or, because +> device paths can change between boots, the disk's serial number, WWN, +> filesystem UUID, or exact size in bytes. Naming a USB or removable +> device here works: the automatic rules above only apply when this field +> is empty. ------------------------------------------------------------------------