Step 1 - Install
  Package managers Apt/Yum users can install from official repositories.

deb (Debian/Ubuntu)

curl -L -O 
sudo dpkg -i filebeat-oss-6.6.2-amd64.deb

rpm (Redhat/Centos/Fedora)

curl -L -O 
sudo rpm -vi filebeat-oss-6.6.2-x86_64.rpm


curl -L -O 
tar xzvf filebeat-oss-6.6.2-darwin-x86_64.tar.gz


docker pull


  • Download the Filebeat Windows zip file from the official downloads page.

  • Extract the contents of the zip file into C:\Program Files.

  • Rename the filebeat-<version>-windows directory to Filebeat.

  • Open a PowerShell prompt as an Administrator (right-click the PowerShell icon and select Run As Administrator). If you are running Windows XP, you may need to download and install PowerShell.

  • Run the following commands to install Filebeat as a Windows service:

    PS > cd 'C:\Program Files\Filebeat'
    PS C:\Program Files\Filebeat> .\install-service-filebeat.ps1`
      If script execution is disabled on your system, you need to set the execution policy for the current session to allow the script to run. For example: PowerShell.exe -ExecutionPolicy UnRestricted -File .\install-service-filebeat.ps1.
  My OS isn't here! Don't see your system? Check out the official downloads page for more options (including 32-bit versions).
Step 2 - Locate the configuration file

deb/rpm /etc/filebeat/filebeat.yml
mac/win <EXTRACTED_ARCHIVE>/filebeat.yml

Step 3 - Configure the inputs

Setup the data you wish to send us, by editing the input path variables.
These fully support wildcards. You can also add a document type.
An example with nginx logs might look like


- type: log
#change to true to enable this input configuration
  enabled: true
    - /var/log/nginx/*.log
    type: nginx-access
  fields_under_root: true
  encoding: utf-8
  exclude_files: [".gz"]
  ignore_older: 3h
  There's also a full example configuration file called filebeat.reference.yml that shows all the possible options.
Step 4 - Configure output

We'll be shipping to Logstash so that we have the option to run filters before the data is indexed.
Comment out the elasticsearch output block.

## Comment out elasticsearch output
#  hosts: ["localhost:9200"]

Uncomment and change the logstash output to match below.

    hosts: ["your-logstash-host:your-port"]
    loadbalance: true
    ssl.enabled: true
Step 5 - Validate configuration

Let's check the configuration file is syntactically correct.


filebeat -e -c /etc/filebeat/filebeat.yml

Ran from the extracted archive dir

filebeat -e -c filebeat.yml
Step 6 - Start filebeat

Ok, time to start ingesting data!


$ sudo service filebeat start


PS C:\Program Files\Filebeat> Start-Service filebeat

Ready to get going?

Try our 14 day free trial

No commitment and no catches

Create Free Trial