We want your experience with Elastic Cloud Enterprise to be a success, so we compiled a list of tried-and-tested prerequisites that will help you install and run our software successfully. To make it easier to look through these prerequisites, we separated them into sections for hardware, software, users, and networking.
The following hardware specifications for host machines work well with Elastic Cloud Enterprise:
- Memory: At least 8 GB of RAM, 64 GB or more preferred
- For allocators handling user requests: Enough storage to support the RAM-to-storage ratio. For example, if you use a host with 16 GB of RAM and the default ratio of 1:32, provide 512 GB of disk space.
- For hosts that will hold other runner roles, such as coordinators, directors and proxies: At least 10 GB of disk space.
The following software works well with Elastic Cloud Enterprise:
One of the following Linux distributions (see Limitations):
- Ubuntu 14.04 LTS (Trusty Tahr)
- Red Hat Enterprise Linux (RHEL) 7 or later
- CentOS 7 or later
- Linux kernel 4.4
- Docker 1.11
- Recommended: XFS file system (required if you want to use disk space quotas for Elasticsearch data directories, but see Limitations)
- If SELinux is enabled: Your SELinux configuration must allow mounting Docker sockets into containers (required for cluster management to work)
Elastic Cloud Enterprise is tested and certified to work on Linux kernel 4.4 and Docker 1.11. These are the kernel and Docker versions Elastic recommends.
Elastic Cloud Enterprise should also work on kernel version 3.10 with Docker 1.11 or 1.12, although these combinations have not been thoroughly tested and might have issues. Elastic will attempt to support Elastic Cloud Enterprise running with these versions, but we might not be able to resolve issues related to the kernel and or Docker. In such cases, you will be asked to move to the certified Kernel and Docker versions, so that we can support you.
Other combinations of Docker and Kernel versions are not supported and should be avoided. Specifically, there is a known issue with kmem accounting when both kernel version 3.19 and Docker version 1.12 are used.
The following users and permissions are required:
- To prepare your environment: A user with sudo permissions, such as the `elastic ` user included with our AWS AMIs or the ubuntu user provided on Ubuntu
To install Elastic Cloud Enterprise: A user who is part of the
dockergroup. You should not install Elastic Cloud Enterprise as the
In the following example You can check your user with the
id command, you can see that the user
elastic is both part of the
uid=1000(elastic) gid=1000(elastic) groups=1000(elastic),4(adm),20(dialout),24(cdrom),25(floppy),27(sudo),29(audio),30(dip),44(video),46(plugdev),102(netdev),112(libvirtd),1001(docker)
The following networking or internet access is required for Elastic Cloud Enterprise:
- Internet access for a typical installation (offline installation is supported)
Outbound traffic open on the following ports:
Host type Outbound ports Purpose
Installation script and container-registry.elastic.co Docker registry access (HTTP)
Installation script and container-registry.elastic.co Docker registry access (HTTPS)
Inbound traffic open from any source on the following ports:
Host type Inbound ports Purpose
Required for troubleshooting
Elastic support access (HTTP)
Elastic support access (HTTPS)
Cloud UI and API access to the administration console (HTTP)
Cloud UI and API access to the administration console (HTTPS)
Kibana and Elasticsearch (HTTP/HTTPS)
Elasticsearch (transport and transport with TLS/SSL)
Internal components of Elastic Cloud Enterprise require inbound traffic open on the following ports:
Host type Inbound ports Purpose
Services forwarder for the administration console
Connections to initial coordinator from allocators and proxies (for up to five coordinators)
12191-12301, 12898-12908, 13898-13908
ZooKeeper stunnels (typically up to five)
ZooKeeper ensemble discovery/joining
Elasticsearch (HTTP and transport)