Repositories for APT and YUM

We have repositories available for APT and YUM-based distributions. Note that we provide binary packages, but no source packages.

We use the PGP key D88E42B4, Elasticsearch Signing Key, with fingerprint

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

to sign all our packages. It is available from https://pgp.mit.edu.

APT

edit

To add the Beats repository for APT:

Download and install the Public Signing Key:

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

You may need to install the apt-transport-https package on Debian before proceeding:
```
sudo apt-get install apt-transport-https
```
Save the repository definition to /etc/apt/sources.list.d/elastic-8.x.list:
```
echo "deb https://artifacts.elastic.co/packages/8.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-8.x.list
```
The package is free to use under the Elastic license. An alternative package which contains only features that are available under the Apache 2.0 license is also available. To install it, use the following sources list:
```
echo "deb https://artifacts.elastic.co/packages/oss-8.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-8.x.list
```
To add the Elastic repository, make sure that you use the echo method shown in the example. Do not use add-apt-repository because it will add a deb-src entry, but we do not provide a source package.

If you have added the deb-src entry by mistake, you will see an error like the following:
```
Unable to find expected entry 'main/source/Sources' in Release file (Wrong sources.list entry or malformed file)
```
Simply delete the deb-src entry from the /etc/apt/sources.list file, and the installation should work as expected.
Run apt-get update, and the repository is ready for use. For example, you can install Metricbeat by running:
```
sudo apt-get update && sudo apt-get install metricbeat
```
To configure Metricbeat to start automatically during boot, run:
```
sudo systemctl enable metricbeat
```
If your system does not use systemd then run:
```
sudo update-rc.d metricbeat defaults 95 10
```

YUM

edit

To add the Beats repository for YUM:

Download and install the public signing key:

sudo rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

Create a file with a .repo extension (for example, elastic.repo) in your /etc/yum.repos.d/ directory and add the following lines:
```
[elastic-8.x]
name=Elastic repository for 8.x packages
baseurl=https://artifacts.elastic.co/packages/8.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=1
autorefresh=1
type=rpm-md
```
The package is free to use under the Elastic license. An alternative package which contains only features that are available under the Apache 2.0 license is also available. To install it, use the following baseurl in your .repo file:
```
baseurl=https://artifacts.elastic.co/packages/oss-8.x/yum
```
Your repository is ready to use. For example, you can install Metricbeat by running:
```
sudo yum install metricbeat
```
To configure Metricbeat to start automatically during boot, run:
```
sudo systemctl enable metricbeat
```
If your system does not use systemd then run:
```
sudo chkconfig --add metricbeat
```

« Metricbeat command reference Run Metricbeat on Docker »