› ›

Appendix A: Install a Fleet-managed Elastic Agent

This guide describes how to:

Install an Elastic Agent that will be managed with Fleet
Enroll the Elastic Agent in Fleet

These steps assume that Elastic Stack is running and an Elastic Integration has been added in Kibana. If this is not true — don’t worry, check out one of the Quick Starts and get started with Elastic Cloud.

You can install only a single Elastic Agent per host.

Prerequisites

edit

The Elastic Stack is running.
You have added an integration in Kibana and are now ready to download and enroll Elastic Agent on your system.

Step 1: Add an Elastic Agent to Fleet

edit

Elastic Agent is a single, unified agent that you can deploy to hosts or containers to collect data and send it to the Elastic Stack. Behind the scenes, Elastic Agent runs the Beats shippers or Elastic Endpoint required for your configuration.

Choose the operating system and run the provided commands to download and extract Elastic Agent on your system.

curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.17.0-darwin-x86_64.tar.gz
tar xzvf elastic-agent-8.17.0-darwin-x86_64.tar.gz

curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.17.0-linux-x86_64.tar.gz
tar xzvf elastic-agent-8.17.0-linux-x86_64.tar.gz

# PowerShell 5.0+
wget https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.17.0-windows-x86_64.zip -OutFile elastic-agent-8.17.0-windows-x86_64.zip
Expand-Archive .\elastic-agent-8.17.0-windows-x86_64.zip

Or manually:

Download the Elastic Agent Windows zip file from the download page.
Extract the contents of the zip file.

To simplify upgrading to future versions of Elastic Agent, we recommended that you use the tarball distribution instead of the RPM distribution.
You can install Elastic Agent in an unprivileged mode that does not require root privileges. Refer to Run Elastic Agent without administrative privileges for details.

curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.17.0-amd64.deb
sudo dpkg -i elastic-agent-8.17.0-amd64.deb

To simplify upgrading to future versions of Elastic Agent, we recommended that you use the tarball distribution instead of the RPM distribution.
You can install Elastic Agent in an unprivileged mode that does not require root privileges. Refer to Run Elastic Agent without administrative privileges for details.

curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.17.0-x86_64.rpm
sudo rpm -vi elastic-agent-8.17.0-x86_64.rpm

Step 2: Enroll and start the Elastic Agent

edit

Return to Kibana and follow the Enroll and start the Elastic Agent instructions. The command provided in Kibana includes the information that Elastic Agent needs to connect and authenticate with the Elastic Stack. When the Elastic Agent enrolls it will be configured to send the data associated with the policy that you created.

« Fleet and Elastic Agent 8.17.0 API »