Search documentation
Getting Started

Installing the Gremlin Agent

In order to use Gremlin on your systems, you'll need to install the Gremlin Agent. The Gremlin Agent is an executable that you install onto the resources you wish to run tests on (i.e. hosts, containers, and Kubernetes clusters). The Gremlin Agent authenticates with Gremlin's backend servers (also called the Gremlin Control Plane), which then allows you to use the Gremlin web app, REST API, or CLI to view your systems and run tests.

Environment-specific instructions

Visit the page specific to the environment(s) you are working with for detailed instructions:

Additional considerations

Installing Gremlin on an AWS VPC (configuring scurity groups and network ACLs)

Installing Gremlin to AWS (and similar firewalled systems) requires additional steps to allow network traffic to and from the Gremlin API. For details, see Installing Gremlin on AWS.

Note that these instructions only cover the Gremlin API. Webhooks and Health Checks use a different set of IP addresses, which you can find on their respective links.

Gremlin Agent Installation Directory Recommendations

Avoid installing the Agent on a network-based filesystem to prevent latency and connectivity issues. Installing on a locally mounted filesystem improves performance and reliability, and reduces the risk of data loss.

Installing Gremlin alongside service meshes (e.g. Istio)

The Gremlin Agent can be safely installed alongside service meshes such as Istio. Gremlin orchestrates network tests without modifying your service mesh's rules or configuration through the use of sidecar containers. This diagram shows how Gremlin applies traffic filtering without modifying Istio:

A diagram showing the Gremlin agent running on a Kubernetes cluster with Istio

Authenticating Gremlin

Once you've installed the Gremlin Agent, continue to Authentication.