Embedded Cluster Install Command Options
This topic describes the options available with the Embedded Cluster install command. For more information about how to install with Embedded Cluster, see Online Installation with Embedded Cluster or Air Gap Installation with Embedded Cluster.
Usage
sudo ./APP_SLUG install --license LICENSE_FILE [flags]
APP_SLUG
is the unique application slugLICENSE_FILE
is the customer's license
Flags
Flag | Description |
---|---|
--admin-console-port | Port on which to run the KOTS Admin Console. Default: By default, the Admin Console runs on port 30000. Limitation: It is not possible to change the port for the Admin Console during a restore with Embedded Cluster. For more information, see Disaster Recovery for Embedded Cluster (Alpha). |
--airgap-bundle | The Embedded Cluster air gap bundle used for installations in air-gapped environments with no outbound internet access. For information about how to install in an air-gapped environment, see Air Gap Installation with Embedded Cluster. |
--cidr | The range of IP addresses that can be assigned to Pods and Services, in CIDR notation. Default: By default, the CIDR block is |
--data-dir | The data directory used by Embedded Cluster. Default: Limitations:
|
--http-proxy | Proxy server to use for HTTP. Requirement: Proxy installations require Embedded Cluster 1.5.1 or later with Kubernetes 1.29 or later. Limitations:
|
--https-proxy | Proxy server to use for HTTPS. Requirement: Proxy installations require Embedded Cluster 1.5.1 or later with Kubernetes 1.29 or later. Limitations:
|
--local-artifact-mirror-port | Port on which to run the Local Artifact Mirror (LAM). Default: By default, the LAM runs on port 50000. |
--no-proxy | Comma-separated list of hosts for which not to use a proxy. For single-node installations, pass the IP address of the node where you are installing. For multi-node installations, when deploying the first node, pass the list of IP addresses for all nodes in the cluster (typically in CIDR notation). The network interface's subnet will automatically be added to the no-proxy list if the node's IP address is not already included. The following are never proxied:
To ensure your application's internal cluster communication is not proxied, use fully qualified domain names like Requirement: Proxy installations require Embedded Cluster 1.5.1 or later with Kubernetes 1.29 or later. Limitations:
|
Examples
Air Gap Install
sudo ./myapp install --license license.yaml --airgap-bundle myapp.airgap
Change the Admin Console and LAM Ports
sudo ./myapp install --admin-console-port=20000 --local-artifact-mirror-port=40000
Change the Data Directory
sudo ./my-app install --license license.yaml --data-dir /data/embedded-cluster
Install Behind a Proxy
sudo ./APP_SLUG install --license LICENSE_FILE \
--http-proxy=HOST:PORT \
--https-proxy=HOST:PORT \
--no-proxy=LIST_OF_HOSTS
Where:
HOST:PORT
is the host and port of the proxy serverLIST_OF_HOSTS
is the list of hosts to not proxy. For example, the IP address of the node where you are installing. Or, for multi-node clusters, the list of IP addresses for all nodes in the cluster, typically in CIDR notation.
Set IP Address Range for Pods and Services
sudo ./my-app install --license license.yaml --cidr 172.16.136.0/16