Install Elastic Cloud Enterprise
You can deploy Elastic Cloud Enterprise (ECE) on public or private clouds, virtual machines, or on-premises.
If you already have an ECE platform up and running, and you want to add hosts to your installation, refer toInstall ECE on additional hosts.
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
Before you start, make sure toidentify your deployment scenario and follow all the referenced sections inPrepare 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.
Make sure to use a supported combination of Linux distribution and container engine version as defined in our officialSupport matrix. Unsupported combinations can lead to various issues in your ECE environment, including failures when creating system deployments, upgrading workload deployments, proxy timeouts, and more.
FIPS (Federal Information Processing Standards) compliance is not officially supported in ECE. While ECE may function on FIPS-enabled systems, this configuration has not been validated through our testing processes and is not recommended for production environments.
ECE supports awide 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:
- Ubuntu 20.04 LTS (Focal Fossa) and Ubuntu 22.04 LTS (Jammy Jellyfish)
- Red Hat Enterprise Linux (RHEL) 8 and 9
- Rocky Linux 8 and 9
- SUSE Linux Enterprise Server (SLES) 12 SP5 and 15
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 thePerform host maintenance instructions.
To install ECE with the official bash script, follow the instructions for thedeployment scenario that best fits your business needs:
- Deploy a small installation: For development, test, and small-scale use cases.
- Deploy a medium installation: For many production setups.
- Deploy a large installation: For deployments with significant overall search and indexing throughput.
- Deploy using Podman: Fresh installation of ECE using Podman hosts.
Alternatively, you can install ECE with theAnsible 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 toAir-gapped install.
Once you have installed ECE, check some finalpost-installation steps to get ready for production.