Skip to main content

Edge Artifact Build Configurations

During the EdgeForge process, you provide an .arg document that contains a list of parameters to configure the build of both the provider images and the Edge Installer ISO. This page lists the parameters available in the .arg file.

ArgumentDescriptionAllowed Values
ARCHArchitecture of the image. Required.amd64, arm64.
AUTO_ENROLL_SECUREBOOT_KEYSDetermines whether to auto enroll keys used for Trusted Boot.true, false. Default is false.
CUSTOM_TAGA custom tag for the provider images. This custom tag will be appended to the IMAGE_REGISTRY and IMAGE_REPO parameters to form the full image tag.Lowercase alphanumeric string without spaces.
FIPS_ENABLEDWhether to generate FIPS compliant binaries.true, false. Default is false
HTTP_PROXYURL of the HTTP Proxy server.URL string.
HTTPS_PROXYURL of the HTTPS Proxy server.URL string.
IMAGE_REGISTRYThe image registry to use for tagging the generated provider images. Required.Your image registry hostname, without http or https
Example: docker.io/spectrocloud.
IMAGE_REPOThe image repository to use for tagging the generated provider images. Required.Your image repository name.
INCLUDE_MS_SECUREBOOT_KEYSWhether to include Microsoft's secure boot keys in the set of keys to enroll in your device for secure boot. Almost every machine requires these keys.true, false. Default is true.
ISO_NAMEName of the Installer ISO file. Required.Lowercase alphanumeric string without spaces. The characters - and _ are allowed.
IS_UKIDetermines whether to build a Unified Kernel Image (UKI) to enabled Trusted Boot. Refer to Trusted Boot for more information.true, false. Default is false.
K8S_DISTRIBUTIONKubernetes distribution. k3s, rke2, kubeadm, kubeadm-fips.
NO_PROXYURLS that should be excluded from the proxy.Comma-separated URL string.
OS_DISTRIBUTIONOS distribution.ubuntu, opensuse-leap, rhel.
OS_VERSIONOS version. This applies to Ubuntu only.20, 22.
PROXY_CERT_PATHAbsolute path of the SSL Proxy certificate in the PEM format.Absolute path string.
UPDATE_KERNELDetermines whether to upgrade the Kernel version to the latest from the upstream OS provider.true, false.