All Products
Search

This Product

    Container Service for Kubernetes:Manage the Nginx Ingress Controller

    Document Center

    Container Service for Kubernetes:Manage the Nginx Ingress Controller

    Last Updated:Jun 15, 2026

    Install, configure, upgrade, or uninstall Nginx Ingress Controller from the ACK console Add-ons page.

    Important

    The open source Ingress-NGINX project will no longer be maintained after March 2026. Container Service for Kubernetes will also stop maintaining the Nginx Ingress Controller. Ensure you understand the associated risks. See [Product Announcement] Announcement on Discontinuation of Nginx Ingress Controller Component Maintenance.

    Install the Nginx Ingress Controller

    Install Nginx Ingress Controller when creating a cluster or add it to an existing cluster.

    On a new cluster

    When creating an ACK cluster, go to the Component Configurations step. In the Ingress section, select Nginx Ingress. Specify the source, type, and specifications of the load balancer.

    On an existing cluster

    1. Log on to the ACK console. In the left navigation pane, click Clusters.

    2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Add-ons.

    3. On the Add-ons page, click the Network tab. Find the Nginx Ingress Controller card and click Install.

    4. In the Install Nginx Ingress Controller dialog box, configure the parameters and click OK.

    Uninstall the Nginx Ingress Controller (optional)

    1. Log on to the ACK console. In the left navigation pane, click Clusters.

    2. On the Clusters page, click the name of your cluster. In the left navigation pane, click Add-ons.

    3. On the Add-ons page, click the Network tab. Find the Nginx Ingress Controller card and click Uninstall.

    4. In the Uninstall dialog box, click OK.

    More operations

    After installation, upgrade or configure the component from the Add-ons page. Go to the Network tab and find the Nginx Ingress Controller card.

    Note the following:

    • A pre-check runs automatically before any upgrade or configuration change to verify that the component meets the upgrade conditions. If the Nginx Ingress Controller has settings that do not meet the upgrade or configuration conditions, or is in an unhealthy state, the health check fails. Manually fix the issues before proceeding with the upgrade or configuration.

    • If the Upgrade button is not displayed on the Nginx Ingress Controller card, the component is up to date. See Upgrade the Nginx Ingress Controller component.