Skip to content

Troubleshooting overview page, Activate Airgapped Enterprise license#234

Merged
sriramveeraghanta merged 6 commits intomasterfrom
updates-system-requirements
Mar 7, 2026
Merged

Troubleshooting overview page, Activate Airgapped Enterprise license#234
sriramveeraghanta merged 6 commits intomasterfrom
updates-system-requirements

Conversation

@danciaclara
Copy link
Collaborator

@danciaclara danciaclara commented Mar 6, 2026

Description

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • Feature (non-breaking change which adds functionality)
  • Improvement (change that would cause existing functionality to not work as expected)
  • Code refactoring
  • Performance improvements
  • Documentation update

Screenshots and Media (if applicable)

Test Scenarios

References

Summary by CodeRabbit

  • Documentation
    • Added a Troubleshooting overview with diagnostics, service-to-log mapping, Docker log links, reporting guidance, and common-issue links.
    • Reorganized Install/Deployment docs with clearer sections, expanded deployment options, and updated hardware guidance (2-core CPU, 4GB RAM, 8GB recommended; broader macOS/Windows WSL2 support).
    • Added an "Activate Airgapped Enterprise" guide and added Overview and Activate entries to the Self‑hosting sidebar.

@vercel
Copy link

vercel bot commented Mar 6, 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 7, 2026 8:28am

Request Review

@coderabbitai
Copy link

coderabbitai bot commented Mar 6, 2026

📝 Walkthrough

Walkthrough

Adds two sidebar links (Troubleshoot → Overview; Manage licenses → Activate Airgapped Enterprise), introduces new troubleshooting and license-activation pages, moves system requirements from top-level overview into the methods overview, and tightens Docker Compose prerequisites to explicit CPU, RAM, and expanded OS support.

Changes

Cohort / File(s) Summary
Sidebar / VitePress config
docs/.vitepress/config.mts
Inserted { text: "Overview", link: "/self-hosting/troubleshoot/overview" } into /self-hosting/ Troubleshoot items and added { text: "Activate Airgapped Enterprise", link: "/self-hosting/manage/manage-licenses/activate-airgapped-enterprise" } into Manage.licenses items.
New troubleshooting page
docs/self-hosting/troubleshoot/overview.md
Added Troubleshooting overview page with service→logs mapping, diagnostic steps, Docker log link guidance, reporting instructions, and common-issues links.
New license activation doc
docs/self-hosting/manage/manage-licenses/activate-airgapped-enterprise.md
Added offline activation guide for Airgapped Enterprise: Prime portal steps, local upload, and activation instructions (includes images).
Methods & deployment docs
docs/self-hosting/methods/overview.md, docs/self-hosting/methods/docker-compose.md
Reworked methods overview: added "System requirements" section and reorganized deployment categories (Container, Platform, Airgapped). Updated Docker Compose prerequisites to specify CPU (2 cores), RAM (4GB, 8GB recommended), and expanded OS list (including macOS and Windows with WSL2).
Main overview
docs/self-hosting/overview.md
Removed the System requirements section from the top-level overview (requirements moved into methods overview).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰
I hopped through pages, nudged a link or two,
Placed fixes, guides, and steps for folks like you,
System needs now hidden where installers roam,
New troubleshooting lights to guide you home,
A rabbit's nibble — hop in, read, and view!

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check ✅ Passed The title addresses two distinct features added in the PR: a troubleshooting overview page and activate airgapped enterprise license documentation, both of which are present in the changeset.

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

✨ Finishing Touches
  • 📝 Generate docstrings (stacked PR)
  • 📝 Generate docstrings (commit on current branch)
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch updates-system-requirements

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

@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: 3

Caution

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

⚠️ Outside diff range comments (1)
docs/self-hosting/methods/overview.md (1)

1-72: ⚠️ Potential issue | 🟡 Minor

Fix Prettier formatting to pass CI.

The pipeline reports a Prettier formatting failure on this file. Run prettier --write docs/self-hosting/methods/overview.md to auto-fix.

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

In `@docs/self-hosting/methods/overview.md` around lines 1 - 72, Prettier
formatting failed for this Markdown; run the formatter (prettier --write) on
this file or reformat the frontmatter and JSX-like CardGroup/Card blocks to
match Prettier rules (ensure consistent indentation, spacing around the YAML
frontmatter, and proper line breaks for Card and CardGroup elements) so CI
passes; target the "title/description/keywords" frontmatter and the
CardGroup/Card components shown in the diff.
🤖 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/troubleshoot/overview.md`:
- Around line 33-36: The links in the list use the incorrect path segment
"/self-hosting/troubleshooting/" causing 404s; update each link (e.g., the
Installation, License, CLI, and Storage links shown) to use
"/self-hosting/troubleshoot/" so they match the actual directory/sidebar
configuration (replace "/self-hosting/troubleshooting/..." with
"/self-hosting/troubleshoot/...").
- Around line 1-4: The frontmatter is missing the required keywords field;
update the markdown frontmatter to include a keywords key alongside the existing
title and description (e.g., add a "keywords: [troubleshooting, self-hosting,
Plane]" entry) so the frontmatter contains title, description, and keywords as
required by the guidelines.
- Around line 1-36: The file with frontmatter titled "Troubleshooting" fails
Prettier; reformat the document to match the project's Markdown style by running
the project's Prettier on this markdown (or apply the same formatting rules):
fix frontmatter spacing, consistent heading spacing, table alignment and code
span backticks so Prettier passes for the "Troubleshooting" doc (docs
self-hosting overview) before pushing.

---

Outside diff comments:
In `@docs/self-hosting/methods/overview.md`:
- Around line 1-72: Prettier formatting failed for this Markdown; run the
formatter (prettier --write) on this file or reformat the frontmatter and
JSX-like CardGroup/Card blocks to match Prettier rules (ensure consistent
indentation, spacing around the YAML frontmatter, and proper line breaks for
Card and CardGroup elements) so CI passes; target the
"title/description/keywords" frontmatter and the CardGroup/Card components shown
in the diff.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 997ea48a-4d16-4e9e-b5c3-80e502cb91d1

📥 Commits

Reviewing files that changed from the base of the PR and between 9f502fd and 779b8ff.

📒 Files selected for processing (5)
  • docs/.vitepress/config.mts
  • docs/self-hosting/methods/docker-compose.md
  • docs/self-hosting/methods/overview.md
  • docs/self-hosting/overview.md
  • docs/self-hosting/troubleshoot/overview.md
💤 Files with no reviewable changes (1)
  • docs/self-hosting/overview.md

Copy link

@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.

♻️ Duplicate comments (1)
docs/self-hosting/troubleshoot/overview.md (1)

1-4: ⚠️ Potential issue | 🟡 Minor

Add missing keywords field to frontmatter.

The frontmatter is missing the required keywords field. As per coding guidelines, every markdown page requires frontmatter with title, description, and keywords fields.

📝 Proposed fix
 ---
 title: Troubleshooting
 description: Diagnose and resolve issues with your self-hosted Plane instance.
+keywords: plane troubleshooting, self-hosting errors, plane logs, debug plane, installation issues
 ---

As per coding guidelines: "Every markdown page requires frontmatter with title, description, and keywords fields"

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

In `@docs/self-hosting/troubleshoot/overview.md` around lines 1 - 4, The
frontmatter at the top of the markdown is missing the required keywords field;
update the YAML frontmatter block that currently contains title and description
to also include a keywords field (e.g., keywords: [plane, troubleshooting]) so
the page has title, description, and keywords; edit the frontmatter region (the
leading --- block) in overview.md to add the keywords entry alongside the
existing title and description fields.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@docs/self-hosting/troubleshoot/overview.md`:
- Around line 1-4: The frontmatter at the top of the markdown is missing the
required keywords field; update the YAML frontmatter block that currently
contains title and description to also include a keywords field (e.g., keywords:
[plane, troubleshooting]) so the page has title, description, and keywords; edit
the frontmatter region (the leading --- block) in overview.md to add the
keywords entry alongside the existing title and description fields.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 428f89f2-c3e1-4dd6-b22d-b6350065bd9a

📥 Commits

Reviewing files that changed from the base of the PR and between 779b8ff and 2e85941.

📒 Files selected for processing (2)
  • docs/self-hosting/methods/overview.md
  • docs/self-hosting/troubleshoot/overview.md

Copy link

@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: 1

♻️ Duplicate comments (1)
docs/self-hosting/troubleshoot/overview.md (1)

1-4: ⚠️ Potential issue | 🟡 Minor

Add the missing keywords frontmatter field.

This page still omits keywords, so it does not satisfy the required Markdown frontmatter shape.

As per coding guidelines: "Every markdown page requires frontmatter with title, description, and keywords fields"

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

In `@docs/self-hosting/troubleshoot/overview.md` around lines 1 - 4, The
frontmatter block is missing the required keywords field; update the YAML
frontmatter at the top of the document (the block containing title and
description) to add a keywords key (e.g., keywords: ["troubleshooting",
"self-hosting", "plane"]) so the page satisfies the required frontmatter shape
including title, description, and keywords.
🤖 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/troubleshoot/overview.md`:
- Around line 10-12: Remove the duplicate section heading '## Identify the
service' by deleting the repeated heading on the second occurrence (the one at
Line 12) or renaming it to the intended subsection title; ensure only one '##
Identify the service' header remains to avoid duplicate anchors and noisy TOC
output and update any following content that depended on the duplicate header if
renaming.

---

Duplicate comments:
In `@docs/self-hosting/troubleshoot/overview.md`:
- Around line 1-4: The frontmatter block is missing the required keywords field;
update the YAML frontmatter at the top of the document (the block containing
title and description) to add a keywords key (e.g., keywords:
["troubleshooting", "self-hosting", "plane"]) so the page satisfies the required
frontmatter shape including title, description, and keywords.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 78ecb9b5-f6ab-4b36-bb45-b22037b8643d

📥 Commits

Reviewing files that changed from the base of the PR and between 2e85941 and 54fae82.

📒 Files selected for processing (4)
  • docs/.vitepress/config.mts
  • docs/public/images/activate-license/upload-airgapped-enterprise.webp
  • docs/self-hosting/manage/manage-licenses/activate-airgapped-enterprise.md
  • docs/self-hosting/troubleshoot/overview.md
✅ Files skipped from review due to trivial changes (1)
  • docs/self-hosting/manage/manage-licenses/activate-airgapped-enterprise.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/.vitepress/config.mts

@danciaclara danciaclara changed the title Troubleshooting overview page Troubleshooting overview page, Activate Airgapped Enterprise license Mar 7, 2026
@sriramveeraghanta sriramveeraghanta merged commit 224c2c0 into master Mar 7, 2026
8 checks passed
@sriramveeraghanta sriramveeraghanta deleted the updates-system-requirements branch March 7, 2026 08:43
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