Skip to content

Latest commit

 

History

History
82 lines (50 loc) · 2.15 KB

README.md

File metadata and controls

82 lines (50 loc) · 2.15 KB

Build Status Download

EveBox

EveBox is a web based Suricata "eve" event viewer for Elastic Search.

EveBox

Requirements

  • Suricata, Logstash and Elastic Search (Elastic Search 2.0 or newer).
  • A modern browser.

Installation.

Download a package and run the evebox application.

Example:

./evebox -e http://localhost:9200

Then visit http://localhost:5636 with your browser.

Up to date builds can be found here: https://bintray.com/jasonish/evebox-development/evebox/_latestVersion#files

This should not require any modification to your Elastic Search configuration. Unlike previous versions of Evebox, you do not need to enable dynamic scripting and CORS.

Docker

If you wish to install EveBox with Docker an up to date image is hosted on Docker hub.

Example:

docker pull jasonish/evebox
docker run -it -p 5636:5636 jasonish/evebox -e http://elasticsearch:9200

replacing your http://elasticsearch:9200 with that of your Elastic Search URL. You most likely do not want to use localhost here as that will be the localhost of the container, not of the host.

OR if you want to link to an already running Elastic Search container:

docker run -it -p 5636:5636 --link elasticsearch jasonish/evebox

Then visit http://localhost:5636 with your browser.

This should not require any modification to your Elastic Search configuration. Unlike previous versions of Evebox, you do not need to enable dynamic scripting and CORS.

Building EveBox

EveBox consists of a JavaScript frontend, and a very minimal backend written in Go.

Frontend requirements:

  • Node.js v4.2.1 or newer.

Backend requirements:

  • A working Go 1.6 installation and GOPATH.

Run in Development Mode

EVEBOX_ELASTICSEARCH_URL=http://localhost:9200 make dev-server

Where the EVEBOX_ELASTICSEARCH_URL is pointing to your Elastic Search server.

License

BSD.