Use the NGINX Controller Agent with Docker
Learn how to use the NGINX Controller Agent in a Docker environment
We support running the NGINX Controller Agent in a Docker environment on the following distributions: CentOS, Debian, and Ubuntu.
We don’t support containerized instances on RHEL 7 and RHEL 8.
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.
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: 3.0, 3.1, 3.2, 3.3, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9, 3.10, 3.12, 3.13, 3.14, 3.15, 3.16.1, 3.17, 3.18, 3.18.1, 3.18.2 and 3.18.3.
This documentation applies to the following versions of NGINX Controller API Management module: 3.18, 3.18.1, 3.19, 3.19.1, 3.19.2, 3.19.3 and 3.19.4.
This documentation applies to the following versions of NGINX Controller App Delivery module: 3.20, 3.20.1, 3.21, 3.22, 3.22.1, 3.22.2 and 3.22.3.