A. Prepare System Charts

The System Charts repository contains all the catalog items required for features such as monitoring, logging, alerting and global DNS. To be able to use these features in an air gap install, you will need to mirror the system-charts repository to a location in your network that Rancher can reach and configure Rancher to use that repository.

Refer to the release notes in the system-charts repository to see which branch corresponds to your version of Rancher.

B. Configure System Charts

Rancher needs to be configured to use your Git mirror of the system-charts repository. You can configure the system charts repository either from the Rancher UI or from Rancher’s API view.

Configuring the Registry from the Rancher UI

In the catalog management page in the Rancher UI, follow these steps:

  1. Go to the Global view.

  2. Click Tools > Catalogs.

  3. The system chart is displayed under the name system-library. To edit the configuration of the system chart, click Ellipsis (…) > Edit.

  4. In the Catalog URL field, enter the location of the Git mirror of the system-charts repository.

  5. Click Save.

Result: Rancher is configured to download all the required catalog items from your system-charts repository.

Configuring the Registry in Rancher’s API View

  1. Log into Rancher.

  2. Open https://<your-rancher-server>/v3/catalogs/system-library in your browser.

    Open

  3. Click Edit on the upper right corner and update the value for url to the location of the Git mirror of the system-charts repository.

    Update

  4. Click Show Request

  5. Click Send Request

Result: Rancher is configured to download all the required catalog items from your system-charts repository.