Skip to content

Conversation

@danciaclara
Copy link
Collaborator

@danciaclara danciaclara commented Jan 12, 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


Note

Enhances the custom domain docs with explicit steps to change domains post-install for Commercial Edition and clarifies configuration for Community Edition.

  • Adds step-by-step flow: inspect current config (grep <old_domain> in /opt/plane/plane.env), edit DOMAIN_NAME, SITE_ADDRESS, WEB_URL, and CORS_ALLOWED_ORIGINS, then restart via prime-cli restart
  • Notes downtime impact and that Prime CLI applies to Docker installs only; mentions Kubernetes users should update equivalent env vars via their own method
  • Expands Community Edition guidance: update .env (WEB_URL, CORS_ALLOWED_ORIGINS) and configure DNS A record (public IP) or reverse proxy/CNAME (internal IP)

Written by Cursor Bugbot for commit d2e611f. This will update automatically on new commits. Configure here.

Summary by CodeRabbit

  • Documentation
    • Expanded custom domain guide with step-by-step instructions for updating domain settings and environment variables
    • Added checks for current domain configuration and example verification output
    • New guidance for restarting services to apply domain changes and a downtime warning about service restarts
    • Enhanced Community Edition instructions for DNS A records and reverse proxy setup for internal IPs

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

@vercel
Copy link

vercel bot commented Jan 12, 2026

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

Project Deployment Review Updated (UTC)
developer-docs Error Error Jan 12, 2026 3:08pm

@coderabbitai
Copy link

coderabbitai bot commented Jan 12, 2026

📝 Walkthrough

Walkthrough

Expands the Plane custom domain guide for self-hosting: clarifies Prime CLI applicability, adds a downtime warning, provides commands to check and update domain-related environment variables, details restarting Prime services, and extends Community Edition guidance for .env updates, DNS A records, and reverse proxy configuration.

Changes

Cohort / File(s) Summary
Documentation Expansion
self-hosting/govern/custom-domain.mdx
Substantially expanded custom-domain guide: clarified Prime CLI vs other deployments; added downtime warning; new "Check current domain configuration" with env var inspection commands; "Update domain in environment file" listing DOMAIN_NAME, SITE_ADDRESS, WEB_URL, CORS_ALLOWED_ORIGINS; "Restart Plane services" with prime-cli restart commands and notes; extended Community Edition section with .env update instructions, DNS A record guidance for public IPs, and reverse proxy configuration guidance for internal IPs.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 I nibble at docs with a hop and a grin,
I stitch domain guides so changes fit in,
Prime CLI hums, envs set just right,
DNS and proxies tucked in at night,
Hooray — the rabbit approves the write! 🥕

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and specifically describes the main change: adding instructions for changing custom domains on the Commercial Edition, which is the primary focus of the expanded guide.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

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

✨ Finishing touches
  • 📝 Generate docstrings

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

🤖 Fix all issues with AI agents
In @self-hosting/govern/custom-domain.mdx:
- Around line 55-63: Under the "Restart Plane services" section, remove the
leading four-space indentation from the paragraph and fenced code block so the
header, the explanatory line ("Apply your configuration changes by restarting
Plane:"), the code fence (```bash), the command (sudo prime-cli restart), and
the following sentence ("This process typically takes a few minutes...") are all
flush with the left margin; ensure the code block uses a proper fenced block
(```bash ... ```) with no extra spaces before the backticks or the command.
📜 Review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between af15bab and 5304bdb.

📒 Files selected for processing (1)
  • self-hosting/govern/custom-domain.mdx
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Cursor Bugbot
🔇 Additional comments (4)
self-hosting/govern/custom-domain.mdx (4)

6-16: LGTM!

The introduction clearly explains the use case, and the warnings about Prime CLI requirements and downtime planning are well-placed and helpful for users.


17-34: LGTM!

Clear instructions for identifying variables that need updating. The example output helps users understand what to expect.


35-53: LGTM!

Clear step-by-step instructions with proper formatting notes for CORS configuration.


64-112: No changes detected in this section.

The Community Edition accordion content appears to be existing documentation shown for context. No review comments needed for unchanged content.

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

Caution

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

⚠️ Outside diff range comments (1)
self-hosting/govern/custom-domain.mdx (1)

88-88: Ambiguous cross-references need clarification.

The phrases "follow the steps here" and "follow these steps" don't clearly indicate which sections to follow. Consider referencing the section names explicitly.

📝 Suggested fix
-If you are hosting Plane on a public IP, then follow the steps here. However, if you are hosting Plane on an internal IP then follow these steps.
+If you are hosting Plane on a public IP, follow the **Set DNS A record** section below. If you are hosting Plane on an internal IP, follow the **Configure reverse proxy** section instead.
🤖 Fix all issues with AI agents
In @self-hosting/govern/custom-domain.mdx:
- Around line 57-64: The "Restart Plane services" section has extra 4-space
indentation that causes inconsistent MDX rendering; remove the leading spaces so
the paragraph and fenced code block are left-aligned with the section header,
replacing the indented "sudo prime-cli restart" and surrounding triple backticks
with an unindented code fence (```bash ... ```), and unindent the following
sentence so it reads as a normal paragraph under the header; locate the "Restart
Plane services" heading and the indented command "sudo prime-cli restart" to
apply this change.
🧹 Nitpick comments (1)
self-hosting/govern/custom-domain.mdx (1)

23-25: Consider quoting the placeholder or adding clarification.

The angle brackets in <old_domain> might confuse users or cause shell interpretation issues. Consider using quotes or adding an example showing the actual substitution.

📝 Suggested improvement
 ```bash
-cat /opt/plane/plane.env | grep <old_domain>
+cat /opt/plane/plane.env | grep "old_domain"

+Replace old_domain with your actual current domain (e.g., grep "example.com").


</details>

</blockquote></details>

</blockquote></details>

<details>
<summary>📜 Review details</summary>

**Configuration used**: defaults

**Review profile**: CHILL

**Plan**: Pro

<details>
<summary>📥 Commits</summary>

Reviewing files that changed from the base of the PR and between 5304bdb3feee9d2a9e8de6e6a3589d2830e64f51 and 9f4aa50b5ad2c38df999409e7c74f4e7e8b2b19d.

</details>

<details>
<summary>📒 Files selected for processing (1)</summary>

* `self-hosting/govern/custom-domain.mdx`

</details>

<details>
<summary>⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)</summary>

* GitHub Check: Cursor Bugbot

</details>

<details>
<summary>🔇 Additional comments (3)</summary><blockquote>

<details>
<summary>self-hosting/govern/custom-domain.mdx (3)</summary><blockquote>

`6-17`: **Well-structured introduction with appropriate warnings.**

The clarification about Prime CLI being Docker-only and the downtime warning are helpful additions that set proper expectations for users before they begin the process.

---

`37-55`: **Clear instructions for updating environment variables.**

The configuration requirements note about protocol usage and CORS formatting is helpful for avoiding common mistakes.

---

`90-112`: **DNS and reverse proxy guidance is clear and comprehensive.**

The instructions appropriately cover both public IP (DNS A record) and internal IP (reverse proxy) scenarios with enough detail to guide users while acknowledging that specific implementations vary.

</blockquote></details>

</blockquote></details>

</details>

<!-- This is an auto-generated comment by CodeRabbit for review status -->

@danciaclara danciaclara merged commit d2dc183 into preview Jan 12, 2026
4 of 6 checks passed
@danciaclara danciaclara deleted the change-custom-domain-commercial branch January 12, 2026 15:12
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.

3 participants