Install Portworx Central on-premises in air-gapped environment

Prepare air-gapped environments

For air-gapped clusters, you must pull the Portworx Central and related Docker images to either your Docker registry or directly onto your nodes:

1. Create a kube_version environment variable, and assign your Kubernetes version to it.

   kube_version=`kubectl version --short | awk -Fv '/Server Version: / {print $3}'`

2. Pull the following required Docker images onto your air-gapped environment:

   • docker.io/portworx/pxcentral-onprem-api: 2.9.1
   • docker.io/portworx/pxcentral-onprem-ui-frontend: 2.9.1
   • docker.io/portworx/pxcentral-onprem-ui-backend: 2.9.1
   • docker.io/portworx/pxcentral-onprem-ui-lhbackend: 2.9.1
   • docker.io/portworx/pxcentral-onprem-post-setup: 2.9.1
   • docker.io/portworx/postgresql: 17.4.0-debian-12-r19
   • docker.io/portworx/keycloak: 26.2.4
   • docker.io/portworx/keycloak-login-theme:
   • docker.io/portworx/busybox: 1.35.0
   • docker.io/portworx/mysql: 8.0.40
   • docker.io/portworx/mongodb: 8.0.9-debian-12-r1
   • docker.io/portworx/mongodb6: 6.0.13-debian-11-r21
   • docker.io/portworx/prometheus: v2.35.0
   • docker.io/portworx/alertmanager: v0.28.0
   • docker.io/portworx/prometheus-operator: v0.56.3
   • docker.io/portworx/prometheus-config-reloader: v0.56.3

Push Docker images to internal registry

To pull the above Docker images and push them to an internal registry:

1. Download the pxcentral-ag-install-central.sh air-gapped bootstrap Portworx Central install script.

   curl -o pxcentral-ag-install-central.sh -L https://install.portworx.com/pxcentral-air-gapped?px-backup=true

   You can also download the install script for a specific release by specifying a version query. For example:

   curl -o pxcentral-ag-install-central.sh -L https://install.portworx.com/pxcentral-air-gapped?version=2.9.1&px-backup=true

2. Pull the container images using the pxcentral-ag-install-central.sh script.

   ./pxcentral-ag-install-central.sh pull

3. Push the images to a local registry server accessible by the air-gapped nodes. Replace <repo> with your registry location.

   ./pxcentral-ag-install-central.sh push <repo>

4. Generate the Portworx Backup installation spec (Helm command) from Portworx Central. Select the Use custom registry checkbox and provide the values for registry, repository, and image pull secret.

   note

   Create a secret, only if image pulling from an internal repository requires credentials.

5. From the machine where you run the helm3 command:

   • Download the latest Portworx Central package with the following command:

     curl -O https://raw.githubusercontent.com/portworx/helm/master/stable/px-central-2.9.1.tgz

   • Modify the Helm command generated from Step 2 to provide the helm package, instead of providing the repository. For example:

     helm install px-central portworx/px-central --namespace central --create-namespace --version 2.9.1 -f values-px-central.yaml

     Following is the modified command for air-gapped environment using the downloaded helm package:

     helm install px-central px-central-2.9.1.tgz --namespace central --create-namespace --version 2.9.1 -f values-px-central.yaml

After pushing the Docker images, refer to the Install Portworx Central on-premises section to install Portworx Central.