Advanced Options

Syntax for Advanced Options

To include advanced options in the kURL installation script, use the following syntax with -s before the advanced option flag:

curl https://kurl.sh/latest | sudo bash -s ADVANCED_FLAG

Where ADVANCED_FLAG is the flag for the advanced option.

For more information about installing with kURL, see Install with kURL.

The install scripts are idempotent. Re-run the scripts with different flags to change the behavior of the installer.

Reference

Flag Description
additional-no-proxy-addresses This indicates addresses that should not be proxied in addition to the private IP. Multiple addresses can be specified as a comma separated list of IPs or a range of addresses in CIDR notation.

Example:
curl https://kurl.sh/latest | sudo bash -s additional-no-proxy-addresses=192.1.1.1
airgap Do not attempt outbound Internet connections while installing.

Example:
curl https://kurl.sh/latest | sudo bash -s airgap
app-version-label A version label that indicates to KOTS which version of an application to install. KOTS will install the latest version if this flag is not passed.
container-log-max-files Specifies the maximum number of container log files that can be present for a container. This does not work with Docker. For Docker, see JSON File logging driver.

Example:
curl https://kurl.sh/latest | sudo bash -s container-log-max-files=2
container-log-max-size A quantity defining the maximum size of the container log file before it is rotated. For example: "5Mi" or "256Ki". This does not work with Docker. For Docker, see JSON File logging driver.

Example:
curl https://kurl.sh/latest | sudo bash -s container-log-max-size=5Mi
exclude-builtin-host-preflights Skips the built-in host preflight checks from running and only runs the vendor-defined checks. See Customizing Host Preflights.

Example:
curl https://kurl.sh/latest | sudo bash -s exclude-builtin-host-preflights
force-reapply-addons Reinstall add-ons, whether or not they have changed since the last time kurl was run.

Example:
curl https://kurl.sh/latest | sudo bash -s force-reapply-addons
ha Install will require a load balancer to allow for a highly available Kubernetes Control Plane.

Example:
curl https://kurl.sh/latest | sudo bash -s ha
host-preflight-ignore Ignore host preflight failures and warnings.

Example:
curl https://kurl.sh/latest | sudo bash -s host-preflight-ignore
ignore-remote-load-images-prompt Bypass prompt to load images on remotes. This is useful for automating upgrades.

Example:
curl https://kurl.sh/latest | sudo bash -s ignore-remote-load-images-prompt
ignore-remote-upgrade-prompt Bypass prompt to upgrade remotes. This is useful for automating upgrades.

Example:
curl https://kurl.sh/latest | sudo bash -s ignore-remote-upgrade-prompt
installer-spec-file This flag takes the path to a ‘patch’ yaml file. The config in this patch will be merged with the existing installer yaml, taking precedence where there is conflict, and will change the installation based on the final config.

Example:
curl https://kurl.sh/latest | sudo bash -s installer-spec-file="./patch.yaml"
kurl-install-directory Override the base directory where kURL will install its dependencies. The path will be suffixed with "/kurl/" ("{kurl-install-directory}/kurl/"). This directory must exist, be writeable by the kURL installer and must have sufficient disk space (5 GB).

Note: The default is /var/lib/.

Example:
curl https://kurl.sh/latest | sudo bash -s kurl-install-directory="/some/dir"
labels Apply the given labels to the node. This flag can be used when initially creating a kURL cluster or when adding a node to an existing kURL cluster.

Example:
curl https://kurl.sh/latest | sudo bash -s labels=gpu=enabled,type=data
load-balancer-address The IP:port of a load balancer for the Kubernetes API servers in HA mode.

Example:
curl https://kurl.sh/latest | sudo bash -s load-balancer-address="34.124.10.32:80"
preserve-docker-config This flag will make the kURL installer keep the current docker config of the node, overriding any yaml config.

Example:
curl https://kurl.sh/latest | sudo bash -s preserve-docker-config
preserve-firewalld-config This flag will make the kURL installer keep the current Firewalld config of the node, overriding any yaml config.

Example:
curl https://kurl.sh/latest | sudo bash -s preserve-firewalld-config
preserve-iptables-config This flag will make the kURL installer keep the current Iptables config of the node, overriding any yaml config.

Example:
curl https://kurl.sh/latest | sudo bash -s preserve-iptables-config
preserve-selinux-config This flag will make the kURL installer keep the current SELinux config of the node, overriding any yaml config.

Example:
curl https://kurl.sh/latest | sudo bash -s preserve-selinux-config
private-address The private IP address of the host.

Example:
curl https://kurl.sh/latest | sudo bash -s private-address="10.128.0.26"
public-address The public IP address.

Example:
curl https://kurl.sh/latest | sudo bash -s public-address="34.139.108.74"
skip-system-package-install This flag will tell kURL to skip installing system packages. The user is responsible for installing the required packages beforehand.

Example:
curl https://kurl.sh/latest | sudo bash -s skip-system-package-install
velero-restic-timeout The time interval that backups/restores of pod volumes are allowed to run before timing out. Default is '4h0m0s'.

Example:
curl https://kurl.sh/latest | sudo bash -s velero-restic-timeout=12h0m0s