Install NGINX Agent

To onboard your F5 WAF for NGINX instances to NGINX Instance Manager, install and configure NGINX Agent on each instance.

1. Use SSH to connect to an F5 WAF for NGINX instance.
   Repeat these steps for each instance you want to onboard.

2. Download the NGINX Agent package from your NGINX Instance Manager host and run the installation script.

   You can group instances that use the same version of F5 WAF for NGINX by including the optional --instance-group flag in the install command.

   Make sure gpg is installed on your system before continuing. You can install NGINX Agent using command-line tools like curl or wget.

   If your NGINX Instance Manager host doesn’t use valid TLS certificates, you can use the insecure flags to bypass verification. Here are some example commands:

   • curl
   • wget

   • Secure:

     Copy

     curl https://<NIM_FQDN>/install/nginx-agent | sudo sh

   • Insecure:

     Copy

     curl --insecure https://<NIM_FQDN>/install/nginx-agent | sudo sh

   To add the instance to a specific instance group during installation, use the --instance-group (or -g) flag:

   Copy

   curl https://<NIM_FQDN>/install/nginx-agent -o install.sh
      chmod u+x install.sh
      sudo ./install.sh --instance-group <instance group>

   By default, the install script uses a secure connection to download packages. If it can’t establish one, it falls back to an insecure connection and logs this message:

   Copy

   Warning: An insecure connection will be used during this nginx-agent installation

   To enforce a secure connection, set the --skip-verify flag to false:

   Copy

   curl https://<NIM_FQDN>/install/nginx-agent -o install.sh
      chmod u+x install.sh
      sudo ./install.sh --skip-verify false

   • Secure:

     Copy

     wget https://<NIM_FQDN>/install/nginx-agent -O - | sudo sh -s --skip-verify false

   • Insecure:

     Copy

     wget --no-check-certificate https://<NIM_FQDN>/install/nginx-agent -O - | sudo sh

   To add your instance to a group during installation, use the --instance-group (or -g) flag:

   Copy

   wget https://<NIM_FQDN>/install/nginx-agent -O install.sh
      chmod u+x install.sh
      sudo ./install.sh --instance-group <instance group>

• Configure NGINX Agent