docs: Helm chart reference, MongoDB Operator guide, and K8s install rework#3010
Merged
Conversation
…bernetes install page Add two new documentation pages and significantly rework the Kubernetes installation guide to reflect current best practices. New pages: - Helm Chart reference covering deployment planning decisions (storage, workload type, MongoDB, Redis, PostgreSQL) and community edition config - MongoDB Kubernetes Operator guide with install, configuration, migration from Bitnami, and troubleshooting Kubernetes install guide changes: - Rewrite intro with deployment planning link and HA guidance - Replace vague system requirements with specific resource breakdown - Remove outdated video embed - Add MongoDB Operator and ingress config to default values.yaml - Pin image version instead of using latest tag - Remove separate Community edition section (moved to Helm Chart page) - Rename "Post-installation configuration" to "Next steps" - Add TLS and uninstall cards to next steps Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
The Google style guide rule [Google.EmDash] requires em dashes without surrounding spaces. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace the outdated "Expose K8s to Internet" page with a focused TLS guide. Ingress setup moved into the install guide; this page now covers TLS termination options: wildcard certs, cert-manager, bring your own, and controller-managed TLS. Adds a warning against using APPSMITH_CUSTOM_DOMAIN on Kubernetes and removes references to the dead ingress.selfSigned option. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Links to the MongoDB Operator page for operator-aware uninstall and provides inline steps for Bitnami/external MongoDB. Updates the uninstall card on the install page to deep-link to the new section. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Replace inline fresh install steps with link to install guide - Remove ArgoCD example (belongs on Helm Chart page if needed) - Reorder migration to expand-move-contract pattern - Add HA scale-down instructions for Deployment workloads - Simplify data migration to dump/restore from single pod - Move Uninstall section after Migration, before Troubleshooting - Update all references to use appsmith-ee namespace and release name - Fix namespace typos in uninstall and troubleshooting sections - Bump minimum K8s version to 1.33+ Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Move Helm Chart, MongoDB Operator, and Ingress/TLS pages into a dedicated "Helm Chart" category under Manage Installation. Add external database links, storage expansion callout, and update cross-references to use new page titles. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Delete configure-tls.mdx (outdated, referenced ingress-nginx and cert-manager v1.5.3) and repoint the three migration guides that linked to it to the new Ingress and TLS page. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Use placeholder values (<APPSMITH_VERSION>, <INGRESS_CLASS>) that break YAML parsing if not replaced, with inline comments explaining how to find the correct values - Add ingress verification step (kubectl get ingress) before DNS/ port-forward step - Use svc/appsmith-ee for port-forward instead of pod name - Update Helm prerequisite to note Helm 4 support - Soften allowVolumeExpansion to a recommendation - Clarify prose to distinguish MongoDB config from ingress config Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Run mongodump/mongorestore from operator pod (Bitnami image lacks the database tools) - Use operator's connection secret for DEST_URI instead of hand-constructed URI - Add explicit PHASE=Running gate before proceeding past step 1 - Add pod termination verification command to step 2 - Clarify step 4 describes connection rewiring - Add backup recommendation before starting migration Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
sebastianiv21
approved these changes
May 20, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Remaining work
Test plan
/getting-started/setup/instance-configuration/helm-chartand/getting-started/setup/instance-configuration/mongodb-kubernetes-operator🤖 Generated with Claude Code