Elastic
Loading

Install Elastic Cloud Enterprise

ECE

You can deploy Elastic Cloud Enterprise (ECE) on public or private clouds, virtual machines, or on-premises.

In ECE, a host refers to any server, VM, or cloud instance where the ECE software is installed. An ECE platform consists of multiple hosts working together to orchestrate Elastic Stack applications.

For public cloud deployments, you can choose from the following providers:

  • Amazon Web Services (AWS)
  • Google Cloud Platform (GCP)
  • Microsoft Azure
Tip

If you already have an ECE platform up and running, and you want to add hosts to your installation, refer to Install ECE on additional hosts.

Note

In these pages we frequently refer to Docker, as its currently the most common container engine, but these instructions are generally valid for Podman as well, with podman replacing docker in commands as appropriate.

Before you start, make sure to identify your deployment scenario and follow all the referenced sections in Prepare your environment. Make sure that your selected infrastructure meets the requirements.

After completing the prerequisites, proceed to configure your ECE hosts. This includes installing Docker or Podman, setting up XFS quotas, preparing mount points, and other required configurations.

ECE supports a wide range of OS versions. Below are some OS-specific instructions for preparing your hosts, though other versions follow a similar process. Choose the appropriate guide for your operating system and follow the instructions:

Important

Cloud providers default provide automatic operating system patching for their virtual machines. We strongly recommend disabling this feature to avoid potential data loss and installation failure. All patching should be done using the Perform host maintenance instructions.

To install ECE with the official bash script, follow the instructions for the deployment scenario that best fits your business needs:

Alternatively, you can install ECE with the Ansible playbook. The ECE Ansible playbook is a community project, supported by Elastic, aimed at installing ECE at scale.

To install ECE in an air-gapped environment, refer to Air-gapped install.

Post-installation steps

Once you have installed ECE, check some final post-installation steps to get ready for production.