{"id":29138674,"url":"https://github.com/nginx/nginx-ingress-helm-operator","last_synced_at":"2026-05-29T12:01:12.540Z","repository":{"id":37404162,"uuid":"466889349","full_name":"nginx/nginx-ingress-helm-operator","owner":"nginx","description":"NGINX Ingress Operator for NGINX and NGINX Plus Ingress Controllers. Based on the Helm chart for NGINX Ingress Controller - https://github.com/nginxinc/helm-charts","archived":false,"fork":false,"pushed_at":"2026-05-28T14:50:25.000Z","size":4436,"stargazers_count":48,"open_issues_count":3,"forks_count":26,"subscribers_count":12,"default_branch":"main","last_synced_at":"2026-05-28T16:21:11.555Z","etag":null,"topics":["k8s","kubernetes","operator"],"latest_commit_sha":null,"homepage":null,"language":"Mustache","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nginx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-03-07T00:11:48.000Z","updated_at":"2026-05-28T14:50:31.000Z","dependencies_parsed_at":"2026-01-13T04:08:31.301Z","dependency_job_id":null,"html_url":"https://github.com/nginx/nginx-ingress-helm-operator","commit_stats":null,"previous_names":["nginx/nginx-ingress-helm-operator","nginxinc/nginx-ingress-helm-operator"],"tags_count":46,"template":false,"template_full_name":null,"purl":"pkg:github/nginx/nginx-ingress-helm-operator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nginx%2Fnginx-ingress-helm-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nginx%2Fnginx-ingress-helm-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nginx%2Fnginx-ingress-helm-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nginx%2Fnginx-ingress-helm-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nginx","download_url":"https://codeload.github.com/nginx/nginx-ingress-helm-operator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nginx%2Fnginx-ingress-helm-operator/sbom","scorecard":{"id":1236790,"data":{"date":"2025-09-01T10:40:45Z","repo":{"name":"github.com/nginx/nginx-ingress-helm-operator","commit":"f83c52328ebb24312e022d7c2dd55f34cffdff1c"},"scorecard":{"version":"v5.2.1","commit":"ab2f6e92482462fe66246d9e32f642855a691dc1"},"score":9.1,"checks":[{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#security-policy"}},{"name":"Maintained","score":10,"reason":"30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#binary-artifacts"}},{"name":"Dependency-Update-Tool","score":10,"reason":"update tool detected","details":["Info: detected update tool: Dependabot: .github/dependabot.yml:1"],"documentation":{"short":"Determines if the project uses a dependency update tool.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#dependency-update-tool"}},{"name":"Token-Permissions","score":10,"reason":"GitHub workflow tokens follow principle of least privilege","details":["Warn: jobLevel 'contents' permission set to 'write': .github/workflows/ci.yml:30","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/dependabot-auto-merge.yml:13","Info: jobLevel 'contents' permission set to 'read': .github/workflows/dependency-review.yml:18","Warn: jobLevel 'actions' permission set to 'write': .github/workflows/f5-cla.yml:24","Info: jobLevel 'contents' permission set to 'read': .github/workflows/f5-cla.yml:25","Warn: jobLevel 'statuses' permission set to 'write': .github/workflows/f5-cla.yml:27","Info: jobLevel 'contents' permission set to 'read': .github/workflows/labeler.yml:11","Info: jobLevel 'contents' permission set to 'read': .github/workflows/notifications.yml:20","Info: jobLevel 'actions' permission set to 'read': .github/workflows/notifications.yml:21","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/sync-chart.yml:49","Info: topLevel 'contents' permission set to 'read': .github/workflows/ci.yml:21","Info: topLevel 'contents' permission set to 'read': .github/workflows/close-operator-pr.yml:12","Info: topLevel 'contents' permission set to 'read': .github/workflows/create-operator-pr.yml:16","Info: topLevel 'contents' permission set to 'read': .github/workflows/delete-operator-branch.yml:11","Info: topLevel 'contents' permission set to 'read': .github/workflows/dependabot-auto-merge.yml:5","Info: topLevel 'contents' permission set to 'read': .github/workflows/dependency-review.yml:12","Info: topLevel 'contents' permission set to 'read': .github/workflows/dockerhub-description.yml:15","Info: topLevel 'contents' permission set to 'read': .github/workflows/e2e-test.yml:29","Info: topLevel 'contents' permission set to 'read': .github/workflows/f5-cla.yml:17","Info: topLevel 'contents' permission set to 'read': .github/workflows/labeler.yml:6","Info: topLevel 'contents' permission set to 'read': .github/workflows/notifications.yml:13","Info: topLevel permissions set to 'read-all': .github/workflows/scorecard.yml:15","Info: topLevel 'contents' permission set to 'read': .github/workflows/stale.yml:7","Info: topLevel 'contents' permission set to 'read': .github/workflows/sync-chart.yml:43"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":10,"reason":"all changesets reviewed","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#dangerous-workflow"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#vulnerabilities"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#signed-releases"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":9,"reason":"dependency not pinned by hash detected -- score normalized to 9","details":["Warn: third-party GitHubAction not pinned by hash: .github/workflows/delete-operator-branch.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/nginx/nginx-ingress-helm-operator/delete-operator-branch.yml/main?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating quay.io/operator-framework/helm-operator:v1.41.1 to quay.io/operator-framework/helm-operator:v1.41.1@sha256:289903c9eab9d28afa76c20ef6367e6f98e08c9bae73b309e37520f02b6175ee","Info:  18 out of  18 GitHub-owned GitHubAction dependencies pinned","Info:  18 out of  19 third-party GitHubAction dependencies pinned","Info:   0 out of   1 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#pinned-dependencies"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#license"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/ci.yml:24"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#packaging"}},{"name":"SAST","score":10,"reason":"SAST tool is run on all commits","details":["Info: all commits (30) are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#sast"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#branch-protection"}},{"name":"Contributors","score":10,"reason":"project has 3 contributing companies or organizations -- score normalized to 10","details":["Info: found contributions from: nginxinc, nginxinc @nginx, opentracing-contrib"],"documentation":{"short":"Determines if the project has a set of contributors from multiple organizations (e.g., companies).","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#contributors"}},{"name":"CI-Tests","score":10,"reason":"30 out of 30 merged PRs checked by a CI test -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project runs tests before pull requests are merged.","url":"https://github.com/ossf/scorecard/blob/ab2f6e92482462fe66246d9e32f642855a691dc1/docs/checks.md#ci-tests"}}]},"last_synced_at":"2025-09-02T11:26:23.506Z","repository_id":37404162,"created_at":"2025-09-02T11:26:23.506Z","updated_at":"2025-09-02T11:26:23.506Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33650712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["k8s","kubernetes","operator"],"created_at":"2025-06-30T14:11:03.359Z","updated_at":"2026-05-29T12:01:12.534Z","avatar_url":"https://github.com/nginx.png","language":"Mustache","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Continuous Integration](https://github.com/nginx/nginx-ingress-helm-operator/workflows/Continuous%20Integration/badge.svg)](https://github.com/nginx/nginx-ingress-helm-operator/actions)\n[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/nginx/nginx-ingress-helm-operator/badge)](https://api.securityscorecards.dev/projects/github.com/nginx/nginx-ingress-helm-operator)\n[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n![Commercial Support](https://badgen.net/badge/support/commercial/green?icon=awesome)\n\n# NGINX Ingress Operator\n\nThe NGINX Ingress Operator is a Kubernetes/OpenShift component which deploys and manages one or more [NGINX/NGINX Plus Ingress Controllers](https://github.com/nginx/kubernetes-ingress) which in turn handle Ingress traffic for applications running in a cluster.\n\nLearn more about operators in the [Kubernetes Documentation](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/).\n\nTo install a specific version of the NGINX Ingress Controller with the operator, a specific version of the NGINX Ingress Operator is required.\n\nUp until version 0.5.1, this Operator was Go based. Version 1.0.0 marks an incompatible upgrade as this release switched the Operator to being Helm-based, built from the [NGINX Ingress Controller Helm chart](http://helm.nginx.com/#nginx-ingress-controller). The configuration for the Helm chart can be seen in the [NGINX Ingress Controller documentation](https://docs.nginx.com/nginx-ingress-controller/install/helm#configuration).\n\nThe following table shows the relation between the versions of the two projects:\n\n| NGINX Ingress Controller | NGINX Ingress Operator |\n| ------------------------ | ---------------------- |\n| 5.5.x                    | 3.6.0                  |\n| 5.4.x                    | 3.5.4                  |\n| 5.3.x                    | 3.4.4                  |\n| 5.2.x                    | 3.3.1                  |\n| 5.1.x                    | 3.2.3                  |\n| 5.0.x                    | 3.1.0                  |\n| 4.0.x                    | 3.0.1                  |\n| 3.7.x                    | 2.4.2                  |\n| 3.6.x                    | 2.3.2                  |\n| 3.5.x                    | 2.2.2                  |\n| 3.4.x                    | 2.1.2                  |\n| 3.3.x                    | 2.0.2                  |\n| 3.2.x                    | 1.5.2                  |\n| 3.1.x                    | 1.4.2                  |\n| 3.0.x                    | 1.3.1                  |\n| 2.4.x                    | 1.2.1                  |\n| 2.3.x                    | 1.1.0                  |\n| 2.2.x                    | 1.0.0                  |\n| 2.1.x                    | 0.5.1                  |\n| 2.0.x                    | 0.4.0                  |\n| 1.12.x                   | 0.3.0                  |\n| 1.11.x                   | 0.2.0                  |\n| 1.10.x                   | 0.1.0                  |\n| 1.9.x                    | 0.0.7                  |\n| 1.8.x                    | 0.0.6                  |\n| 1.7.x                    | 0.0.4                  |\n| \u003c 1.7.0                  | N/A                    |\n\nNote: The NGINX Ingress Operator works only for NGINX Ingress Controller versions after `1.7.0`.\n\n## Getting Started\n\n1. Install the NGINX Ingress Operator. See [docs](./docs/installation.md).\n   \u003cbr\u003e NOTE: To use TransportServers as part of your NGINX Ingress Controller configuration, a GlobalConfiguration resource must be created _before_ starting the Operator - [see the notes](./examples/deployment-oss-min/README.md#TransportServers)\n2. Creating the default-server-secret.yaml is optional and it is recommended that users provide their own certificate. An example yaml for this can be found in the [examples folder](https://github.com/nginx/nginx-ingress-helm-operator/blob/main/examples/default-server-secret.yaml)\n3. (If using OpenShift) Create the scc resource on the cluster by applying the scc.yaml file found in the `resources` folder of this repo:\n\n   ```shell\n   kubectl apply -f https://raw.githubusercontent.com/nginx/nginx-ingress-helm-operator/main/resources/scc.yaml\n   ```\n\n4. Deploy a new NGINX Ingress Controller using the [NginxIngress](./config/samples/charts_v1alpha1_nginxingress.yaml) Custom Resource:\n   - Use the name of the default server secret created above for `controller.defaultTLS.secret` field (needs to be in the form `namespace/name`)\n   - If using NGINX Plus:\n     - Set the `controller.nginxPlus` to true\n     - Set the `controller.image.repository` and `controller.image.tag` to the appropriate values\n     - Set the `controller.serviceAccount.imagePullSecretName` if applicable\n   - For full configuration details see the Helm documentation [here](https://docs.nginx.com/nginx-ingress-controller/install/helm/#configuration).\n\n## Notes: Multiple NIC Deployments\n\n- Please see [the NGINX Ingress Controller documentation](https://docs.nginx.com/nginx-ingress-controller/install/multiple-controllers/) for general information on running multiple NGINX Ingress Controllers in your cluster.\n- To run multiple NIC instances deployed by the NGINX Ingress Operator in your cluster in the same namespace, `rbac.create` should be set to `false`, and the ServiceAccount and ClusterRoleBinding need to be created independently of the deployments. Please note that `controller.serviceAccount.imagePullSecretName` will also be ignored in this configuration, and will need to be configured as part of the independent ServiceAccount creation.\n- The ClusterRoleBinding needs to configured to bind to the `nginx-ingress-operator-nginx-ingress-admin` ClusterRole.\n- See [RBAC example spec](./resources/rbac-example.yaml) for an example ServiceAccount and ClusterRoleBinding manifest.\n- To run multiple NIC instances deployed by the NGINX Ingress Operator in your cluster in any namespace but sharing an IngressClass, `controller.ingressClass.name` should be set to an empty string and the IngressClass resource needs to be created independently of the deployments.Please note that `controller.ingressClass.setAsDefaultIngress` will also be ignored in this configuration, and will need to be configured as part of the independent IngressClass creation.\n- See [IngressClass example spec](./resources/ingress-class.yaml) for an example IngressClass manifest.\n\n## Upgrades\n\nSee [upgrade docs](./docs/upgrades.md)\n\n## NGINX Ingress Operator Releases\n\nWe publish NGINX Ingress Operator releases on GitHub. See our [releases page](https://github.com/nginx/nginx-ingress-helm-operator/releases).\n\nThe latest stable release is [3.6.0](https://github.com/nginx/nginx-ingress-helm-operator/releases/tag/v3.6.0). For production use, we recommend that you choose the latest stable release.\n\n## Development\n\nIt is possible to run the operator in your local machine. This is useful for testing or during development.\n\n### Run Operator locally\n\n1. Have access to a Kubernetes/OpenShift cluster.\n2. Apply the IC CRD:\n\n   ```shell\n    make install\n   ```\n\n3. Run `make run`.\n\nThe operator will run in your local machine but will be communicating with the cluster.\n\n## Contributing\n\nIf you'd like to contribute to the project, please read our [Contributing](./CONTRIBUTING.md) guide.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnginx%2Fnginx-ingress-helm-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnginx%2Fnginx-ingress-helm-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnginx%2Fnginx-ingress-helm-operator/lists"}