Skip to content

Running Tracee with Docker

This guide will help you get started with running Tracee as a container.

Prerequisites

Tracee container image

Tracee container image is available in Docker Hub as aquasec/tracee.

  • You can use the latest tag or a named version version e.g aquasec/tracee:v0.22.0-128-gb56ee730c.
  • If you are trying the most cutting edge features, there is also a dev tag which is built nightly from source.
  • The Tracee image is a Multi-platform image that includes a x86 and arm64 flavors. You can also access the platform-specific images directly with the aarch64 and x86_64 tags for the latest version or aarch64-<version> and x86_64-<version> for a specific version.
  • For most first time users, just use aquasec/tracee!

Running Tracee container

Here is the docker run command, we will analyze it next:

docker run --name tracee -it --rm \
  --pid=host --cgroupns=host --privileged \
  -v /etc/os-release:/etc/os-release-host:ro \
  -v /var/run:/var/run:ro \
  aquasec/tracee:latest
  1. Docker general flags:
    • --name - name our container so that we can interact with it easily.
    • --rm - remove the container one it exits, assuming this is an interactive trial of Tracee.
    • -it - allow the container to interact with your terminal.
  2. Since Tracee runs in a container but is instrumenting the host, it will need access to some resources from the host:

After running this command, you should start seeing a stream of events that Tracee is emitting.

For next steps, please read about Tracee Policies

Installing Tracee

If you are looking to permanently install Tracee, you would probably do the following:

  1. Remove interactive flags -it and replace with daemon flag -d
  2. Consider how to collect events from the container.

Or you can follow the Kubernetes guide which addresses these concerns.