Breaking Changes

Use this section to choose the environment‑specific guide for migrating from NGINX Agent v2 to NGINX Agent v3.

Breaking changes

• Environment variables renamed (v2 → v3):

  • NGINX_AGENT_SERVER_HOST → NGINX_AGENT_COMMAND_SERVER_HOST
  • NGINX_AGENT_SERVER_GRPCPORT → NGINX_AGENT_COMMAND_SERVER_PORT
  • NGINX_AGENT_SERVER_TOKEN → NGINX_AGENT_COMMAND_AUTH_TOKEN
  • Ensure the new variables are set correctly before deployment.
  • Complete list of Agent v3 environment variables:

• Config Sync Groups:

  • In v3, apply the label using: NGINX_AGENT_LABELS: config-sync-group=

Plan and test your migration

Do not run v2 and v3 concurrently on the same host, pod, or container. Test in a non‑production environment first and schedule a maintenance window for production.