Skip to content

docs: update airgapped edition instructions for docker-compose and environment variables#253

Merged
danciaclara merged 2 commits intomasterfrom
fix-airgapped-docs
Mar 30, 2026
Merged

docs: update airgapped edition instructions for docker-compose and environment variables#253
danciaclara merged 2 commits intomasterfrom
fix-airgapped-docs

Conversation

@akshat5302
Copy link
Copy Markdown
Member

@akshat5302 akshat5302 commented Mar 30, 2026

Description

This pull request updates the airgapped installation instructions in the documentation to ensure users download the correct Docker Compose and environment variable files for airgapped deployments.

Documentation improvements:

  • Updated the airgapped installation guide in docs/self-hosting/methods/airgapped-edition.md to instruct users to download docker-compose-airgapped.yml and variables-airgapped.env instead of the standard files.

Type of Change

  • Bug fix (non-breaking change which fixes an issue)

Summary by CodeRabbit

  • Documentation
    • Updated the airgapped self-hosting installation guide: download commands now fetch airgapped-specific Docker Compose and environment template artifacts while leaving the local output filenames unchanged.

@vercel
Copy link
Copy Markdown

vercel bot commented Mar 30, 2026

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

Project Deployment Actions Updated (UTC)
developer-docs Ready Ready Preview, Comment Mar 30, 2026 1:47pm

Request Review

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 30, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 77a7b782-03fa-4c5b-ba87-88ea9c19a89a

📥 Commits

Reviewing files that changed from the base of the PR and between e0af658 and ee3b8f2.

📒 Files selected for processing (1)
  • docs/self-hosting/methods/airgapped-edition.md
✅ Files skipped from review due to trivial changes (1)
  • docs/self-hosting/methods/airgapped-edition.md

📝 Walkthrough

Walkthrough

Updated the airgapped installation docs to download airgapped-specific artifacts: retrieve docker-compose-airgapped.yml as docker-compose.yml and variables-airgapped.env as plane.env during setup.

Changes

Cohort / File(s) Summary
Documentation Update
docs/self-hosting/methods/airgapped-edition.md
Changed download targets in installation steps to use docker-compose-airgapped.yml (saved as docker-compose.yml) and variables-airgapped.env (saved as plane.env).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

🐰 I hopped through docs with careful paws,
Swapped filenames to match airgapped laws,
-airgapped.yml now leads the way,
plane.env ready for the day,
A tiny hop, a tidy cause.

🚥 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 summarizes the main change: updating airgapped edition documentation to reference the correct docker-compose and environment variable files for airgapped deployments.
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.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix-airgapped-docs

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

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

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/self-hosting/methods/airgapped-edition.md`:
- Line 57: Update the inline header text that currently reads "# Download
docker-compose.yml" to match the file being downloaded (change it to "# Download
docker-compose-airgapped.yml") so the comment reflects the actual command and
filename used in the docs.
- Around line 58-61: The docs mix two different file sets
(docker-compose-airgapped.yml / plane-airgapped.env vs plane.env /
docker-compose.yml) which breaks the airgapped flow; update all references so
the same airgapped filenames are used throughout: when downloading use
docker-compose-airgapped.yml and plane-airgapped.env, instruct users to edit
plane-airgapped.env (not plane.env), update docker-compose-airgapped.yml (not
docker-compose.yml), and start the stack with docker compose -f
docker-compose-airgapped.yml up -d (or include -f docker-compose-airgapped.yml
wherever the non-airgapped compose file is currently referenced).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 33df2b1c-b67a-4ed0-9a33-03ec3d2b810f

📥 Commits

Reviewing files that changed from the base of the PR and between 12647e1 and e0af658.

📒 Files selected for processing (1)
  • docs/self-hosting/methods/airgapped-edition.md

@@ -55,10 +55,10 @@ Consider these alternatives:

```bash
# Download docker-compose.yml
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Update the inline comment to match the downloaded file name.

Line 57 says # Download docker-compose.yml, but the command downloads docker-compose-airgapped.yml.

Suggested doc fix
-   # Download docker-compose.yml
+   # Download docker-compose-airgapped.yml
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
# Download docker-compose.yml
# Download docker-compose-airgapped.yml
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosting/methods/airgapped-edition.md` at line 57, Update the inline
header text that currently reads "# Download docker-compose.yml" to match the
file being downloaded (change it to "# Download docker-compose-airgapped.yml")
so the comment reflects the actual command and filename used in the docs.

Comment on lines +58 to +61
curl -fsSL https://prime.plane.so/releases/<plane-version>/docker-compose-airgapped.yml -o docker-compose-airgapped.yml

# Download environment template
curl -fsSL https://prime.plane.so/releases/<plane-version>/variables.env -o plane.env
curl -fsSL https://prime.plane.so/releases/<plane-version>/variables-airgapped.env -o plane-airgapped.env
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Use one consistent airgapped file set across all steps.

The flow currently downloads docker-compose-airgapped.yml and plane-airgapped.env, but later tells users to edit/use plane.env, update docker-compose.yml, and start without -f docker-compose-airgapped.yml. This will cause failed or incorrect deployments.

Suggested doc fix
-   Edit the `plane.env` file to configure your deployment:
+   Edit the `plane-airgapped.env` file to configure your deployment:

-   **Update image references** in `docker-compose.yml` to point to your private registry:
+   **Update image references** in `docker-compose-airgapped.yml` to point to your private registry:

-   docker compose --env-file plane.env up -d
+   docker compose -f docker-compose-airgapped.yml --env-file plane-airgapped.env up -d

Also applies to: 66-66, 78-78, 126-126

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/self-hosting/methods/airgapped-edition.md` around lines 58 - 61, The
docs mix two different file sets (docker-compose-airgapped.yml /
plane-airgapped.env vs plane.env / docker-compose.yml) which breaks the
airgapped flow; update all references so the same airgapped filenames are used
throughout: when downloading use docker-compose-airgapped.yml and
plane-airgapped.env, instruct users to edit plane-airgapped.env (not plane.env),
update docker-compose-airgapped.yml (not docker-compose.yml), and start the
stack with docker compose -f docker-compose-airgapped.yml up -d (or include -f
docker-compose-airgapped.yml wherever the non-airgapped compose file is
currently referenced).

…es for docker-compose and environment variables
@danciaclara danciaclara merged commit 8f568ee into master Mar 30, 2026
8 checks passed
@danciaclara danciaclara deleted the fix-airgapped-docs branch March 30, 2026 13:48
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