Skip to content

Iris docs: state the suite's tenancy and identity provider limits - #4529

Merged
rbs333 merged 2 commits into
docs/iris-suite-local-install-feedbackfrom
docs/iris-suite-tenancy-limits
Nov 10, 2026
Merged

rbs333 merged 2 commits into
docs/iris-suite-local-install-feedbackfrom
docs/iris-suite-tenancy-limits

Conversation

@plamilieva

@plamilieva plamilieva commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

Adds a "Tenancy and identity provider limits" section to the suite page, on top of #4520.

A redis-iris release has one tenant, one issuer, and one audience, all taken from global.iris. The section lists the service values that fail the render when they differ, and the Not supported row now links to it.

Each failure was reproduced with helm template against the 1.0.0 chart: a product tenantId, tenant_id_claim, a different static_tenant_id, role_mappings, issuer, jwks_uri, and audience.

Not covered: multi-tenant mode in the standalone charts, which the docs don't support as installs and the Identity Service page marks as undecided.

The docs build isn't run.

Also fixes the CLI check step (step 7 of the install): it needs .env.admin loaded as well as .env. I ran the CLI steps against a local suite release: create and all five check hops pass once both files are loaded.

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only changes to install guidance; no product code or deployment behavior changes.

Overview
Updates the self-managed Iris suite install guide with clearer single-tenant / single-IdP constraints and a small CLI verification fix.

Adds Tenancy and identity provider limits, explaining that each redis-iris release pins one tenant, OIDC issuer, and token audience via global.iris, and that per-service values that override those settings fail Helm render (with a table of forbidden fields). It also notes that another namespace/release is required for a second tenant, and that cross-tenant rejection checks don’t apply to the suite.

Step 7 of the iris CLI flow now documents loading both .env.admin and .env before iris agent-memory service check, since the check needs admin and store settings.

The Not supported table row for multi-tenant installs is expanded to issuer/audience and links to the new section.

Reviewed by Cursor Bugbot for commit debb5ba. Bugbot is set up for automated code reviews on this repo. Configure here.

Adds the values that fail the render when they differ from global.iris
(tenantId, tenant_id_claim, static_tenant_id, role_mappings, issuer,
jwks_uri, audience), each checked with helm template against the 1.0.0
chart. Links the Not supported row to it.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@CLAassistant

CLAassistant commented Nov 10, 2026 •

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@github-actions

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

🧠 Redis Memory

Found 7 related items from repository history (2 new this commit):

Memory updated at debb5ba

The check needs IRIS_CONFIG, IRIS_PROFILE and the admin tokens from
.env.admin as well as the store settings in .env. Without them in the
shell it fails with "set ... (or --service-url, or --local)". Verified
by running the CLI steps against a local suite release.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@dwdougherty dwdougherty added the iris Iris context engine docs label Nov 10, 2026
@rbs333
rbs333 merged commit 15212e4 into docs/iris-suite-local-install-feedback Nov 10, 2026
109 of 111 checks passed
@rbs333
rbs333 deleted the docs/iris-suite-tenancy-limits branch November 10, 2026 15:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

iris Iris context engine docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants