Customizing the Simplified Provisioner ISO
Fedora IoT provides a generic Simplified Provisioning ISO that is by default configured to install to a virtual disk (/dev/vda
). This can be customized for your device depending on what hardware you have (nvme0, sda, mmcblk0) and configuration option you would like to leverage - FDO or Ignition.
Creating a custom Simplified Provisioner
With use of the mkksiso
tool its possible to create a customized installer that can be used to install and configure most devices.
Example with FIDO Device Onboard
This example:
-
Uses the
--cmdline
option to add thefdo.manufacturing_server_url
to specify the FDO Manufacturing server to be used during the installation. NOTE: Replace the URL with that of your FDO Manufacturing server url. -
Uses the
--replace
option to update the installation device and remove thequiet
option from the kernel arguments so boot message are shown on screen -
Uses the generic ISO -
Fedora-IoT-provisioner-42-20250618.0.x86_64.iso
creating a new ISO namedFedora-IoT-provisioner-FDO-42-20250618.0.x86_64.iso
sudo mkksiso --cmdline "fdo.manufacturing_server_url=http://192.168.1.26:8080 fdo.diun_pub_key_insecure=true" \ --replace quiet "" \ --replace vda sda \ Fedora-IoT-provisioner-42-20250618.0.x86_64.iso Fedora-IoT-provisioner-FDO-42-20250618.0.x86_64.iso
Example with Ignition
This example:
-
Uses the
--cmdline
option to add theignition.config.url
to specify the location of the Ignition configuration file. NOTE: Replace the URL with that of your Ignition file. -
Uses the
--replace
option to update the installation device to usenvme0
-
Uses the generic ISO -
Fedora-IoT-provisioner-42-20250618.0.x86_64.iso
creating a new ISO namedFedora-IoT-provisioner-IGN-42-20250618.0.x86_64.iso
sudo mkksiso --cmdline "coreos.inst.append=ignition.config.url=http://192.168.1.25/configs/ignition/config.ign" \ --replace vda nvme0 \ Fedora-IoT-provisioner-42-20250618.0.x86_64.iso Fedora-IoT-provisioner-IGN-42-20250618.0.x86_64.iso
Troubleshooting issues
When troubleshooting issues with the Simplified-Provisioner it may be helpful to use the `coreos.inst.skip_reboot` option to prevent automatic reboot after installation completes.
Want to help? Learn how to contribute to Fedora Docs ›