It is time to say goodbye: This version of Elastic Cloud Enterprise has reached end-of-life (EOL) and is no longer supported.

The documentation for this version is no longer being maintained. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

« Install ECE offline Without a private Docker registry »
Elastic Docs ›Elastic Cloud Enterprise Reference [2.12] ›Installing Elastic Cloud Enterprise ›Install ECE on your own premises ›Install ECE offline

With your private Docker registry

edit

With your private Docker registry

edit

Installing ECE on multiple hosts with your own registry server is simpler, because you do not have to load the Docker images on each host.

  1. Set up your private Docker registry. To learn more, see Deploy a registry server

    As part of the ECE high availability strategy, it’s a good idea to make sure that your Docker registry server is available to all ECE allocators, so that it can continue to be accessed in the event of a network partition or zone outage. Allocators attempting to start instances requiring Docker images that have not yet been pulled from a custom Docker registry will fail to start if the registry is unavailable.

  2. On an internet-connected host that has Docker installed, download the Available Docker Images and push them to your private Docker registry. While an Elastic Cloud Enterprise version may include Docker images for more than one major release (for example 6.x and 7.x), you need to download only the set of Docker images corresponding to a single major release, as shown in these steps.

    docker pull docker.elastic.co/cloud-enterprise/elastic-cloud-enterprise:2.12.1
docker pull docker.elastic.co/cloud-assets/elasticsearch:7.15.0-0
docker pull docker.elastic.co/cloud-assets/kibana:7.15.0-0
docker pull docker.elastic.co/cloud-assets/apm:7.15.0-0
docker pull docker.elastic.co/cloud-assets/enterprise-search:7.15.0-0

    For example, for Elastic Cloud Enterprise 2.12.1 and the Elastic Stack versions it shipped with, you need:

    • Elastic Cloud Enterprise 2.12.1
    • Elasticsearch 7.15.0-0, Kibana 7.15.0-0, APM 7.15.0-0, and Enterprise Search 7.15.0-0

  3. Tag the Docker images with your private registry, where REGISTRY is my.private.repo:5000, for example:

    docker tag docker.elastic.co/cloud-enterprise/elastic-cloud-enterprise:2.12.1 REGISTRY/cloud-enterprise/elastic-cloud-enterprise:2.12.1
docker tag docker.elastic.co/cloud-assets/elasticsearch:7.15.0-0 REGISTRY/cloud-assets/elasticsearch:7.15.0-0
docker tag docker.elastic.co/cloud-assets/kibana:7.15.0-0 REGISTRY/cloud-assets/kibana:7.15.0-0
docker tag docker.elastic.co/cloud-assets/apm:7.15.0-0 REGISTRY/cloud-assets/apm:7.15.0-0
docker tag docker.elastic.co/cloud-assets/enterprise-search:7.15.0-0 REGISTRY/cloud-assets/enterprise-search:7.15.0-0

  4. Push the Docker images to your private Docker registry, where REGISTRY is my.private.repo:5000, for example:

    docker push REGISTRY/cloud-enterprise/elastic-cloud-enterprise:2.12.1
docker push REGISTRY/cloud-assets/elasticsearch:7.15.0-0
docker push REGISTRY/cloud-assets/kibana:7.15.0-0
docker push REGISTRY/cloud-assets/apm:7.15.0-0
docker push REGISTRY/cloud-assets/enterprise-search:7.15.0-0

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

    curl -L -O https://download.elastic.co/cloud/elastic-cloud-enterprise.sh
  6. Copy the installation script to each host where you plan to install Elastic Cloud Enterprise. (Alternatively, you can place the installation script in a secure network location where your other hosts can access it.)

  7. Invoke the installation script on each host with the --docker-registry REGISTRY parameter, where REGISTRY is my.private.repo:5000, for example:

    1. On the first host:

      bash elastic-cloud-enterprise.sh install
  --docker-registry REGISTRY

    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, along with the --docker-registry REGISTRY parameter:

      bash elastic-cloud-enterprise.sh install
  --coordinator-host HOST_IP
  --roles-token 'TOKEN'
  --docker-registry REGISTRY
« Install ECE offline Without a private Docker registry »