Skip to content


Gremlins can be used in CI pipelines using the prebuilt Docker images.

As a pipeline step

In the continuous integration tool of your choice, you can execute a step using the following syntax:

docker run --rm -v $(pwd):/app -w /app gogremlins/gremlins:0.5.0 gremlins unleash .

The exact way to specify a runner step in the pipeline script depends on the tool of choice.

As a stage in the Dockerfile

Gremlins can be also run as a stage in the Dockerfile.

FROM gogremlins/gremlins:0.5.0 AS mutation-testing
WORKDIR /my/project/source
RUN gremlins unleash

For further details, please refer to the Docker multi stage builds documentation.