Upgrade NGINX Agent package

Overview

Learn how to upgrade NGINX Agent.

Upgrade NGINX Agent from version v2.31.0 or greater

Starting from version v2.31.0, NGINX Agent will automatically restart itself during an upgrade.

To upgrade NGINX Agent, follow these steps:

  1. Open an SSH connection to the server where you’ve installed NGINX Agent and log in.

  2. Make a backup copy of the following locations to ensure that you can successfully recover if the upgrade has issues:

    • /etc/nginx-agent
    • config_dirs values for any configuration specified in /etc/nginx-agent/nginx-agent.conf

  3. Install the updated version of NGINX Agent:

    • CentOS, RHEL, RPM-Based

      sudo yum -y makecache
sudo yum update -y nginx-agent

    • Debian, Ubuntu, Deb-Based

      sudo apt-get update
sudo apt-get install -y --only-upgrade nginx-agent -o Dpkg::Options::="--force-confold"

Upgrade NGINX Agent from a version less than v2.31.0

To upgrade NGINX Agent, take the following steps:

  1. Open an SSH connection to the server where you’ve installed NGINX Agent and log in.

  2. Make a backup copy of the following locations to ensure that you can successfully recover if the upgrade has issues:

    • /etc/nginx-agent
    • config_dirs values for any configuration specified in /etc/nginx-agent/nginx-agent.conf

  3. Stop NGINX Agent:

    sudo systemctl stop nginx-agent

  4. Install the updated version of NGINX Agent:

    • CentOS, RHEL, RPM-Based

      sudo yum -y makecache
sudo yum update -y nginx-agent

    • Debian, Ubuntu, Deb-Based

      sudo apt-get update
sudo apt-get install -y --only-upgrade nginx-agent -o Dpkg::Options::="--force-confold"

  5. Start NGINX Agent:

    sudo systemctl start nginx-agent
Last modified March 19, 2025