A. Collect Image Sources

Using a computer with internet access, browse to our releases page and find the Rancher 2.x.x release that you want to install. Don’t download releases marked rc or Pre-release, as they are not stable for production environments.

Choose Release Version

From the release’s Assets section, download the following three files, which are required to install Rancher in an air gap environment:

Release File Description
rancher-images.txt This file contains a list of all files needed to install Rancher.
rancher-save-images.sh This script pulls all the images in the rancher-images.txt from Docker Hub and saves all of the images as rancher-images.tar.gz.
rancher-load-images.sh This script loads images from the rancher-images.tar.gz file and pushes them to your private registry.

B. Publish Images

After collecting the release files, publish the images from rancher-images.txt to your private registry using the image scripts.

Note: Image publication may require up to 20GB of empty disk space.

  1. From a system with internet access, use the rancher-save-images.sh with the rancher-images.txt image list to create a tarball of all the required images.

    ./rancher-save-images.sh --image-list ./rancher-images.txt
  2. Copy rancher-load-images.sh, rancher-images.txt and rancher-images.tar.gz files to the Linux host that you’ve provisioned by completing the substeps below.

    1. Log into your registry if required.

      docker login <REGISTRY.YOURDOMAIN.COM:PORT>
    2. Use rancher-load-images.sh to extract, tag and push the images to your private registry.

      ./rancher-load-images.sh --image-list ./rancher-images.txt --registry <REGISTRY.YOURDOMAIN.COM:PORT>

Next: Choose an SSL Option and Install Rancher