Install Elastic Agents

edit

Restrictions

Note the following restrictions when installing Elastic Agent on your system:

  • You can install only a single Elastic Agent per host. Due to the fact that the Elastic Agent may read data sources that are only accessible by a superuser, Elastic Agent will therefore also need to be executed with superuser permissions.
  • You might need to log in as a root user (or Administrator on Windows) to run the commands described here. After the Elastic Agent service is installed and running, make sure you run these commands without prepending them with ./ to avoid invoking the wrong binary.
  • Running Elastic Agent commands using the Windows PowerShell ISE is not supported.
  • See also the minimum requirements described on this page.

You have a few options for installing and managing an Elastic Agent:

Restrictions in Serverless

If you are using Elastic Agent with Elastic Cloud Serverless, note these differences from use with Elasticsearch Service and self-managed Elasticsearch:

  • The number of Elastic Agents that may be connected to an Elastic Cloud Serverless project is limited to 10 thousand.
  • The minimum supported version of Elastic Agent supported for use with Elastic Cloud Serverless is 8.11.0.

Minimum requirements

edit

The following are the minimum system requirements for installing Elastic Agent.

CPU and RSS memory size

edit

Minimum requirements have been determined by running the Elastic Agent on a GCP e2-micro instance (2vCPU/1GB). The Elastic Agent used the default policy, running the system integration and self-monitoring.

CPU

Under 2% total, including all monitoring processes

RSS memory size

400 MB

Adding integrations will increase the memory used by the agent and its processes.

Size on disk

edit

The disk requirements for Elastic Agent vary by operating system and Elastic Stack version. With version 8.14 we have significantly reduced the size of the Elastic Agent binary. Further reductions are planned to be made in future releases.

Operating system 8.13 8.14

Linux

1800 MB

1018 MB

macOS

1100 MB

619 MB

Windows

891 MB

504 MB

During upgrades, double the disk space is required to store the new Elastic Agent binary. After the upgrade completes, the original Elastic Agent is removed from disk to free up the space.