Dashboard
Platform

Updating Gremlin

It's important to keep Gremlin up to date, in order to take advantage of new features and important bug fixes. Review Gremlin's release notes for a full list of releases and associated changes.

Staying informed on the latest Gremlin updates

Gremlin releases new agent versions regularly. If you're installing pinned versions of Gremlin, you'll want to update your version pins when we release a new version. Stay up to date on the most recent version by subscribing to our RSS feeds:

Linux packages

YUM

To upgrade to the latest gremlin packages:

SHELL

# You can also use specific versions (e.g. `gremlin-2.16.4 gremlind-2.16.4`).
sudo yum update gremlin gremlind

APT

To upgrade to the latest gremlin packages:

SHELL

# You can also use specific versions (e.g. `gremlin@2.16.4 gremlind@2.16.4`).
sudo apt update && sudo apt upgrade gremlin gremlind

Container images

Gremlin hosts its gremlin/gremlin and gremlin/chao images on Docker Hub. They are tagged according to their release version.

If using the tag value of latest with a PullPolicy of Always, be mindful of Docker's image pull rate-limiting.

Kubernetes

SHELL

# VERSION=2.17.3
# CHAO_VERSION=0.3.0
kubectl set image daemonset/gremlin gremlin=gremlin/gremlin:$VERSION
kubectl set image deployment/chao chao=gremlin/chao:$CHAO_VERSION

Helm

In addition to updating Gremlin agents, you'll also want to check for updates to the Gremlin Helm Chart.

Upgrading Gremlin Helm Chart

SHELL

helm repo update

Upgrading Gremlin Agents

SHELL

# VERSION=2.17.3
# CHAO_VERSION=0.3.0
helm upgrade -n gremlin gremlin gremlin/gremlin \
    --set image.tag=$VERSION \
    --set chaoimage.tag=$CHAO_VERSION \
    # NOTE: make sure you supply all helm values relevant to your installation

Other considerations for updating Gremlin

Downloading deb packages

SHELL

# To download the latest version
apt download gremlin gremlind
# To download a specific version
apt download gremlin=2.18.5-1 gremlind=2.18.5-1

Downloading rpm packages

If you are supplying Gremlin packages to Linux machines outside of Gremlin's yum repository, you can download versions of the packages without installing them. Gremlin recommends using YUM's download-only functionality. YUM stores packages in <span class="code-class-custom">/var/cache/</span> (see yumdownloader(1))

SHELL

# To download the latest version
yum install --downloadonly gremlin gremlind
# To download a specific version
yum install --downloadonly gremlin-2.18.5 gremlind-2.18.5

Without Yum Downloader

While Gremlin recommends downloading packages with YUM. You can download any Gremlin version with a BASH script like the one below:

SHELL

#!/bin/bash
## Download a Gremlin RPM without using yum
##
## requires: curl, xpath, gzip
##
VERSION=$(curl https://rpm.gremlin.com/noarch/latest | cut -d- -f1)
## Or optionally set a specific version
# VERSION=2.16.3
curl -fsSL https://rpm.gremlin.com/noarch/$(\
    curl -fsSL https://rpm.gremlin.com/noarch/$(\
        curl -fsSL https://rpm.gremlin.com/noarch/repodata/repomd.xml \
            | xpath -e "string(/repomd/data[@type=\"primary\"]/location/@href)" 2>/dev/null) \
        | gunzip \
        | xpath -e "string(/metadata/package[version/@ver=\"${VERSION}\" and name=\"gremlin\"][last()]/location/@href)" 2>/dev/null) \
    -o gremlin-${VERSION}.x86_64.rpm
curl -fsSL https://rpm.gremlin.com/noarch/$(\
    curl -fsSL https://rpm.gremlin.com/noarch/$(\
        curl -fsSL https://rpm.gremlin.com/noarch/repodata/repomd.xml \
            | xpath -e "string(/repomd/data[@type=\"primary\"]/location/@href)" 2>/dev/null) \
        | gunzip \
        | xpath -e "string(/metadata/package[version/@ver=\"${VERSION}\" and name=\"gremlind\"][last()]/location/@href)" 2>/dev/null) \
    -o gremlind-${VERSION}.x86_64.rpm
No items found.
Previous
Next
Previous
This is some text inside of a div block.
Compatibility
Installing the Gremlin Agent
Authenticating the Gremlin Agent
Configuring the Gremlin Agent
Managing the Gremlin Agent
User Management
Integrations
Health Checks
Notifications
Command Line Interface
Updating Gremlin
Reliability Management (RM) Quick Start Guide
Services and Dependencies
Detected Risks
Reliability Tests
Reliability Score
Targets
Experiments
Scenarios
GameDays
Overview
Deploying Failure Flags on AWS Lambda
Deploying Failure Flags on AWS ECS
Deploying Failure Flags on Kubernetes
Classes, methods, & attributes
API Keys
Examples
Container security
General
Linux
Windows
Chao
Helm
Glossary
Additional Configuration for Helm
Amazon CloudWatch Health Check
AppDynamics Health Check
Blackhole Experiment
CPU Experiment
Certificate Expiry
Custom Health Check
Custom Load Generator
DNS Experiment
Datadog Health Check
Disk Experiment
Dynatrace Health Check
Grafana Cloud Health Check
Grafana Cloud K6
IO Experiment
Install Gremlin on Kubernetes manually
Install Gremlin on OpenShift 4
Installing Gremlin on AWS - Configuring your VPC
Installing Gremlin on Kubernetes with Helm
Installing Gremlin on Windows
Installing Gremlin on a virtual machine
Installing the Failure Flags SDK
Jira
Latency Experiment
Memory Experiment
Network Tags
New Relic Health Check
Overview
Overview
Overview
Overview
Overview
Packet Loss Attack
PagerDuty Health Check
Preview: Gremlin in Kubernetes Restricted Networks
Private Network Integration Agent
Process Collection
Process Killer Experiment
Prometheus Health Check
Configuring Role Based Access Control (RBAC)
Running Failure Flags experiments
Scheduling Scenarios
Shared Scenarios
Shutdown Experiment
Slack
Managing Teams
Time Travel Experiment
Troubleshooting Gremlin on OpenShift
User Authentication via SAML and Okta
Managing Users
Webhooks
Integration Agent for Linux
Test Suites
Restricting Testing Times
Reports
Process Exhaustion Experiment
Enabling DNS collection
Authenticating Users with Microsoft Entra ID (Azure Active Directory) via SAML
AWS Quick Start Guide
Installing Gremlin on Amazon ECS