Installation

Event Forwarder is released as a container image, RPM package, and standalone Linux binary for amd64 and arm64.

  • Docker image

  • RPM package

  • Standalone binary

Release images are published to:

registry.evertrust.io/event-forwarder

Run the image directly and mount a persistent volume for cursor state:

docker pull registry.evertrust.io/event-forwarder:latest

docker run --rm \
  -e SERVICE_ENDPOINT="https://service.example.com/api/v1/events/search" \
  -e SERVICE_API_KEY="$SERVICE_API_KEY" \
  -e SERVICE_STATE_FILE="/var/lib/event-forwarder/state.json" \
  -v event-forwarder-state:/var/lib/event-forwarder \
  registry.evertrust.io/event-forwarder:latest \
  --daemon \
  --poll-interval 10s

This mode is useful when your existing logging stack already scrapes Docker or Kubernetes container stdout.

Installing from the Evertrust repository

Create a /etc/yum.repos.d/event-forwarder.repo file containing the EverTrust repository info:

[event-forwarder]
enabled=1
name=Event Forwarder Repository
baseurl=https://repo.evertrust.io/repository/event-forwarder-rpm/
gpgcheck=1
gpgkey=https://evertrust.io/.well-known/rpm/gpg.pub
username=<username>
password=<password>

Replace <username> and <password> with the credentials you were provided.

Make sure the Evertrust GPG key is trusted:

# rpm --import https://evertrust.io/.well-known/rpm/gpg.pub

You can then run the following to install the latest Event Forwarder version:

# yum install event-forwarder

To prevent unattended upgrades when running yum update, pin the Event Forwarder version by adding the following line at the end of /etc/yum.repos.d/event-forwarder.repo after installing Event Forwarder:

exclude=event-forwarder

Installing from the package file

Download the latest RPM for Event Forwarder from the Official EVERTRUST repository.

Upload the file event-forwarder-<latest>.<arch>.rpm to the server. Replace <arch> with the target RPM architecture, such as x86_64 or aarch64.

Access the server with an account with administrative privileges.

Install the Event Forwarder package with the following command:

# yum localinstall /root/event-forwarder-<latest>.<arch>.rpm

If you wish to verify the signature of the RPM package, the EVERTRUST key can be added to your trusted keys using the following command:

# rpm --import https://evertrust.io/.well-known/rpm/gpg.pub

The signature can then be verified using the following command:

# rpm -K /root/event-forwarder-<latest>.<arch>.rpm

The RPM installs the binary as:

/usr/bin/event-forwarder

Download the raw Linux binary for your architecture from GitHub releases:

event-forwarder_<version>_linux_amd64
event-forwarder_<version>_linux_arm64

Install it in a directory on PATH:

VERSION="v0.0.0"
chmod +x "./event-forwarder_${VERSION}_linux_amd64"
sudo install -m 0755 "./event-forwarder_${VERSION}_linux_amd64" /usr/local/bin/event-forwarder

Check the installed version:

event-forwarder --version