Skip to content

docs: explain installing cert-manager into a different namespace - #2212

Open
yugstar wants to merge 1 commit into
cert-manager:masterfrom
yugstar:docs-944-namespace-install
Open

docs: explain installing cert-manager into a different namespace#2212
yugstar wants to merge 1 commit into
cert-manager:masterfrom
yugstar:docs-944-namespace-install

Conversation

@yugstar

@yugstar yugstar commented Jul 22, 2026

Copy link
Copy Markdown

Closes #944

Adds an "Installing into a different namespace" subsection to the Helm installation docs. It covers:

  • Installing into a non-default namespace via --namespace.
  • A clarification that cert-manager stays cluster-scoped — the install namespace only controls where the controller/webhook/cainjector Deployments and their leader-election Lease live, not the scope of resources it manages (a common point of confusion).
  • Setting global.leaderElection.namespace so the leader-election Lease lives in the install namespace instead of kube-system — needed on restricted/multi-tenant clusters where the ServiceAccount must not access kube-system.

Add a section to the Helm install docs covering installing into a
non-default namespace, the cluster-scoped clarification (the namespace
only affects where the components and leader-election Lease live), and
setting global.leaderElection.namespace when the ServiceAccount must not
access kube-system.

Closes cert-manager#944

Signed-off-by: Aman Raj <aman.yug@gmail.com>
@cert-manager-prow cert-manager-prow Bot added the dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. label Jul 22, 2026
@cert-manager-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign hawksight for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@cert-manager-prow cert-manager-prow Bot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Jul 22, 2026
@netlify

netlify Bot commented Jul 22, 2026

Copy link
Copy Markdown

Deploy Preview for cert-manager ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 1529739
🔍 Latest deploy log https://app.netlify.com/projects/cert-manager/deploys/6a60e4230c3c440008fa1b98
😎 Deploy Preview https://deploy-preview-2212--cert-manager.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dco-signoff: yes Indicates that all commits in the pull request have the valid DCO sign-off message. size/S Denotes a PR that changes 10-29 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document how to install cert-manager in a different namespace

2 participants