Loading

Air-gapped install without a private Docker registry

ECE

To perform an offline installation without a private Docker registry, you have to download the required Docker images on each host.

  1. On an internet-connected host with Docker installed, download the Docker images required by the Elastic Cloud Enterprise version you want to install. Refer to available docker images for more information.

    For example, for Elastic Cloud Enterprise 4.0.1 and the Elastic Stack versions it includes, you need:

    docker pull docker.elastic.co/cloud-enterprise/elastic-cloud-enterprise:4.0.1
    docker pull docker.elastic.co/cloud-release/elasticsearch-cloud-ess:8.18.2
    docker pull docker.elastic.co/cloud-release/kibana-cloud:8.18.2
    docker pull docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.2
    docker pull docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.2
    docker pull docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.1
    docker pull docker.elastic.co/cloud-release/kibana-cloud:9.0.1
    docker pull docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.1
    
    Note

    Version 8.x images are required for system deployments.

  2. Create .tar files of the images:

    docker save -o ece.4.0.1.tar docker.elastic.co/cloud-enterprise/elastic-cloud-enterprise:4.0.1
    docker save -o es.8.18.2.tar docker.elastic.co/cloud-release/elasticsearch-cloud-ess:8.18.2
    docker save -o kibana.8.18.2.tar docker.elastic.co/cloud-release/kibana-cloud:8.18.2
    docker save -o apm.8.18.2.tar docker.elastic.co/cloud-release/elastic-agent-cloud:8.18.2
    docker save -o enterprise-search.8.18.2.tar docker.elastic.co/cloud-release/enterprise-search-cloud:8.18.2
    docker save -o es.9.0.1.tar docker.elastic.co/cloud-release/elasticsearch-cloud-ess:9.0.1
    docker save -o kibana.9.0.1.tar docker.elastic.co/cloud-release/kibana-cloud:9.0.1
    docker save -o apm.9.0.1.tar docker.elastic.co/cloud-release/elastic-agent-cloud:9.0.1
    
  3. Copy the .tar files to a location on your network where they are available to each host where you plan to install Elastic Cloud Enterprise. Alternatively, you can copy the .tar files to each host directly.

  4. On each host, load the images into Docker, replacing FILE_PATH with the correct path to the .tar files:

    docker load < FILE_PATH/ece.4.0.1.tar
    docker load < FILE_PATH/es.8.18.2.tar
    docker load < FILE_PATH/kibana.8.18.2.tar
    docker load < FILE_PATH/apm.8.18.2.tar
    docker load < FILE_PATH/enterprise-search.8.18.2.tar
    docker load < FILE_PATH/es.9.0.1.tar
    docker load < FILE_PATH/kibana.9.0.1.tar
    docker load < FILE_PATH/apm.9.0.1.tar
    
  5. Optional: Remove the .tar files after installation.

  6. On an internet-connected host, download the installation script:

    curl -L -O https://download.elastic.co/cloud/elastic-cloud-enterprise.sh
    
  7. Copy the installation script to each host where you plan to install Elastic Cloud Enterprise or make it available on your network.

  8. Invoke the installation script on each host:

    Note

    The installation commands for this method are the same as in a standard installation. Refer to ECE installation procedures for details on the installation steps and the parameters required by the installation script, which vary based on your installation size.

    1. On the first host:

      bash elastic-cloud-enterprise.sh install
      
    2. On additional hosts, include the --coordinator-host HOST_IP and --roles-token 'TOKEN' parameters provided to you when you installed on the first host:

      bash elastic-cloud-enterprise.sh install
        --coordinator-host HOST_IP
        --roles-token 'TOKEN'
      

    Once the installation is complete, refer to Log into the Cloud UI to access Cloud UI.