Skip to content

docs: RDS IAM Authentication#1178

Draft
brendanshanahan wants to merge 2 commits intoopen-webui:devfrom
brendanshanahan:feat/rds-iam-auth-docs
Draft

docs: RDS IAM Authentication#1178
brendanshanahan wants to merge 2 commits intoopen-webui:devfrom
brendanshanahan:feat/rds-iam-auth-docs

Conversation

@brendanshanahan
Copy link
Copy Markdown

@brendanshanahan brendanshanahan commented Apr 10, 2026

Summary

This PR adds documentation for the AWS RDS IAM database authentication feature introduced in open-webui/open-webui (PR linked below).

Changes:

  • docs/getting-started/advanced-topics/rds-iam-authentication.md
    • Covers prerequisites (enabling IAM auth on RDS, IAM policy, GRANT rds_iam TO , SSL CA bundle), environment variable configuration, Docker Compose and Kubernetes examples, token refresh behavior, and a troubleshooting section.
  • docs/reference/env-configuration.mdx
    • Adds entries for the two new environment variables introduced by the linked PR:
      • DATABASE_ENABLE_IAM_TOKEN_AUTH — enables IAM token auth in place of a static password
      • DATABASE_CA_PATH — path to the RDS CA certificate bundle for SSL verification

Implementation PR: open-webui/open-webui#23580

Related discussion: open-webui/open-webui#20783

@pr-validator-bot
Copy link
Copy Markdown

ℹ️ Documentation PR Guidelines

👋 Welcome! This is an automated message posted on all new documentation PRs to help guide our contributors. Just because this comment appeared doesn't mean you have done anything wrong!

Please ensure you're using the correct branches:

Target branch (where you're merging TO):

  • dev branch: For documentation related to upcoming Open WebUI releases (new features, new environment variables, anything dependent on unreleased versions and unreleased features/fixes/changes)
  • main branch: For content that can go live immediately (fixes, tutorials, documentation not dependent on unreleased features)

Source branch (where you're merging FROM):

  • If targeting dev, create your branch from your fork's dev branch
  • If targeting main, create your branch from your fork's main branch
  • ⚠️ Mismatched branches can and will result in unwanted file changes being included in your PR!

If your docs PR depends on a pending PR in open-webui/open-webui:

  • Convert this PR to DRAFT mode!
  • Link to the related main repo PR in your description for clarity
  • We'll review both together once the PR on the main repo is merged

Please adjust your PR target branch, source branch, and/or draft status accordingly if needed.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants