enabled in your server's firmware settings. Secure boot needs to be disabled
when booting an installer prior to {pmg} version 8.1.
+[thumbnail="../installer/pmg-grub-menu.png"]
+
After choosing the correct entry (for example, Boot from USB) the {pmg} menu
will be displayed, and one of the following options can be selected:
-image::images/installer/pmg-grub-menu.png[]
-
Install {pmg} (Graphical)::
Start normal installation.
can be used if the machine is completely headless and only has a serial console
available.
+[thumbnail="../installer/pmg-tui-installer.png"]
+
Both modes use the same code base for the actual installation process to
benefit from more than a decade of bug fixes and ensure feature parity.
run this option.
You normally select *Install {pmg} (Graphical)* to start the installation.
-image::images/installer/pmg-select-target-disk.png[]
+
+[thumbnail="../installer/pmg-select-target-disk.png"]
The first step is to read our EULA (End User License Agreement). Following
this, you can select the target hard disk(s) for the installation.
WARNING: ZFS on top of any hardware RAID is not supported and can result in data
loss.
-image::images/installer/pmg-select-location.png[]
+[thumbnail="../installer/pmg-select-location.png", float="left"]
The next page asks for basic configuration options like your
location, timezone, and keyboard layout. The location is used to
change them in rare situations when auto-detection fails, or when you want to
use a keyboard layout not commonly used in your country.
-image::images/installer/pmg-set-password.png[]
+[thumbnail="../installer/pmg-set-password.png"]
You then need to specify an email address and the superuser (root)
password. The password must have at least 5 characters, but we highly
All those notification mails will be sent to the specified email address.
-image::images/installer/pmg-setup-network.png[]
+[thumbnail="../installer/pmg-setup-network.png"]
The next step is the network configuration. Please note that you can use either
IPv4 or IPv6 here, but not both. If you want to configure a dual stack node,
you can easily do that after the installation.
-image::images/installer/pmg-summary.png[]
+[thumbnail="../installer/pmg-installation.png", float="left"]
When you press `Next`, you will see an overview of your entered configuration.
Please re-check every setting, you can still use the `Previous` button to go
After clicking `Install`, the installer will begin to format and copy packages
to the target disk(s).
-image::images/installer/pmg-installation.png[]
+[thumbnail="../installer/pmg-summary.png"]
Copying the packages usually takes several minutes. When this is
finished, you can reboot the server.
# zpool add <pool-name> log </dev/path_to_fast_ssd>
---
+Adding the `nomodeset` Kernel Parameter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Problems may arise on very old or very new hardware due to graphics drivers. If
+the installation hangs during the boot. In that case, you can try adding the
+`nomodeset` parameter. This prevents the Linux kernel from loading any
+graphics drivers and forces it to continue using the BIOS/UEFI-provided
+framebuffer.
+
+On the {pmg} bootloader menu, navigate to 'Install {pmg} (Terminal UI)' and
+press `e` to edit the entry. Using the arrow keys, navigate to the line starting
+with `linux`, move the cursor to the end of that line and add the
+parameter `nomodeset`, separated by a space from the pre-existing last
+parameter.
+
+Then press `Ctrl-X` or `F10` to boot the configuration.
+
[[pmg_install_on_debian]]
Install {pmg} on Debian
-----------------------