Skip to content
/ evebox Public
forked from jasonish/evebox

Web Based Event Viewer (GUI) for Suricata EVE Events in Elastic Search

License

Notifications You must be signed in to change notification settings

sbilly/evebox

 
 

Repository files navigation

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.

About

Web Based Event Viewer (GUI) for Suricata EVE Events in Elastic Search

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 77.3%
  • Go 13.1%
  • HTML 3.8%
  • Shell 2.7%
  • Makefile 2.0%
  • JavaScript 0.6%
  • CSS 0.5%