Use the NGINX Controller Agent with Docker

Before You Begin

For optimal performance when using the Controller Agent in a Docker environment, the number of containers shouldn’t exceed the number of processors on the container host.

Running NGINX Controller Agent in Docker

When running a containerized instance on an Ubuntu or Debian docker host, you need to enable cgroup swap limit capabilities in order for the NGINX Controller Agent to be able to report swap metrics for instances. See Docker - Linux post-installation steps for details.

Refer to the nginxinc/docker-nginx-controller repository in GitHub for a set of guidelines that you can use today as we continue to enhance the experience.


This documentation applies to the following versions of NGINX Controller Documentation: 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9, 3.10, 3.11, 3.12, 3.13, 3.14, 3.15, 3.16, 3.17 and 3.18.