[DOCSW-552] Enhance airgapped edition documentation for docker compose deployments

[akshat5302]

Description

This pull request updates the documentation for deploying Plane in airgapped environments, with a focus on clarifying prerequisites, improving instructions for Docker-based deployments, and ensuring OpenSearch is included among recommended infrastructure alternatives. The changes streamline the setup process, emphasize the use of managed services for reliability, and enhance clarity for users preparing and running airgapped installations.

Type of Change

• Documentation update

Summary by CodeRabbit

• Documentation
  • Updated airgapped deployment guides to use Docker Compose with private registry configuration instead of offline bundles.
  • Added OpenSearch as a recommended alternative service for airgapped environments.
  • Simplified installation and startup procedures with streamlined configuration steps.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
developer-docs	Error		Jan 21, 2026 10:28am

[coderabbitai]

📝 Walkthrough

Walkthrough

Documentation updates for airgapped deployments: adds OpenSearch as a recommended alternative to the Kubernetes guide and significantly restructures the Docker Compose guide to shift from pre-packaged offline bundle model to a private registry-based deployment approach with pre-configured Docker images.

Changes

Cohort / File(s)	Summary
Airgapped Kubernetes Guide self-hosting/methods/airgapped-edition-kubernetes.mdx	Adds OpenSearch as recommended alternative service in warning section; includes OpenSearch Docker image in infrastructure images list for airgapped pre-pull/transfer.
Airgapped Docker Compose Guide self-hosting/methods/airgapped-edition.mdx	Comprehensive rewrite: replaces pre-packaged offline bundle narrative with private registry-based deployment model. Updates prerequisites to reference managed services alternatives (MinIO, Redis, PostgreSQL, RabbitMQ, OpenSearch). Revises installation flow from license/downloader acquisition to Docker image preparation, docker-compose.yml download, and private registry configuration. Introduces MACHINE_SIGNATURE generation and domain configuration steps. Simplifies startup to direct docker compose up command with standardized health checks. Restructures licensing activation flow numbering and updates UI label references.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 A registry awaits, no bundles to unpack,
Docker Compose now leads us down the private track,
OpenSearch joins the fold, in Kubernetes it springs,
Pre-pulled images soar on airgapped wings! 🎪

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: enhancing airgapped edition documentation specifically for Docker Compose deployments, which aligns with the substantial rewrite converting from an offline bundle approach to a Docker Compose with private registry approach.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[makeplane]

Linked to Plane Work Item(s)

• [DOCSW-552] Update Airgapped Docker instructions

This comment was auto-generated by Plane

[coderabbitai]

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)

self-hosting/methods/airgapped-edition-kubernetes.mdx (1)

56-62: Inconsistent Valkey image reference.

Line 57 references valkey:7.2.5-alpine while Line 135 (unchanged, but relevant) uses valkey/valkey:7.2.11-alpine. The Docker Compose guide (airgapped-edition.mdx) consistently uses valkey/valkey:7.2.11-alpine. This discrepancy could confuse users preparing their airgapped environment.

Suggested fix

     - `valkey:7.2.5-alpine`
+    - `valkey/valkey:7.2.11-alpine`

🧹 Nitpick comments (1)

self-hosting/methods/airgapped-edition.mdx (1)

52-62: Consider adding version placeholder clarification.

The <plane-version> placeholder in the download URLs should be explicitly called out, with guidance on where users can find available versions. The Kubernetes guide references Artifact Hub for version information.

Suggested addition

 2. **Download Docker Compose configuration**

     Download the Docker Compose configuration files from the official release.
+    Replace `<plane-version>` with your target version (e.g., `1.6.4`). Check for the latest version at [Prime releases](https://prime.plane.so/releases).

     ```bash
     # Download docker-compose.yml