Skip to content

Docker AIO #137

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: preview
Choose a base branch
from
Open

Docker AIO #137

wants to merge 2 commits into from

Conversation

danciaclara
Copy link
Collaborator

@danciaclara danciaclara commented Aug 6, 2025

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

  • New Features
    • Added a new documentation page with detailed setup and configuration instructions for deploying the Plane Commercial All-in-One (AIO) Docker image.
  • Documentation
    • Updated the navigation structure to include the new Docker AIO and Airgapped Edition pages, and adjusted the order of existing items for improved clarity.
    • Renamed the Airgapped Edition documentation title for consistency.

Copy link

vercel bot commented Aug 6, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
developer-docs ❌ Failed (Inspect) Aug 6, 2025 11:04am

Copy link

coderabbitai bot commented Aug 6, 2025

Walkthrough

The changes introduce a new documentation page for deploying the Plane Commercial All-in-One Docker image, update the navigation structure in the configuration file to include this new page and reorder another related page, and make a minor title adjustment to the airgapped edition documentation. No code or exported entities were modified.

Changes

Cohort / File(s) Change Summary
Navigation Configuration
mint.json
Added "self-hosting/methods/docker-aio" and reordered "self-hosting/methods/airgapped-edition" in the Install group within the navigation array. No other navigation or content changes.
New Docker AIO Documentation
self-hosting/methods/docker-aio.mdx
Added a comprehensive new documentation file for the Plane Commercial All-in-One Docker image, covering included services, prerequisites, installation, configuration, troubleshooting, and production considerations.
Airgapped Edition Title Update
self-hosting/methods/airgapped-edition.mdx
Changed the document title from "Deploy Plane Commercial Airgapped Edition" to "Deploy Plane Airgapped Edition." No other content changes.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant Docs Navigation
    participant Docker AIO Doc
    participant Airgapped Edition Doc

    User->>Docs Navigation: Opens Install navigation menu
    Docs Navigation->>User: Shows updated order with Docker AIO and Airgapped Edition links

    User->>Docker AIO Doc: Selects "All-in-One Docker" page
    Docker AIO Doc->>User: Displays setup, configuration, and troubleshooting instructions

    User->>Airgapped Edition Doc: Selects "Airgapped Edition" page
    Airgapped Edition Doc->>User: Displays page with updated title
Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~7 minutes

Poem

🐇
In docs we add a Docker guide,
Where all-in-one containers now reside.
A title tweak, a menu shift,
Navigation gets a tidy lift.
With volumes, ports, and SSL dreams—
Deploying Plane is simpler, it seems!
—Your friendly rabbit 🥕

Note

⚡️ Unit Test Generation is now available in beta!

Learn more here, or try it out under "Finishing Touches" below.

✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docker-aio

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
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai generate unit tests to generate unit tests for this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

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

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

2-2: Title/body mismatch – clarify edition naming

The title drops the word “Commercial”, but Line 6 still says “Commercial Airgapped Edition”. Either re-insert “Commercial” into the title or remove it from the body to avoid reader confusion and preserve search/SEO consistency.

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between a0324ae and 76f3d29.

📒 Files selected for processing (3)
  • mint.json (1 hunks)
  • self-hosting/methods/airgapped-edition.mdx (1 hunks)
  • self-hosting/methods/docker-aio.mdx (1 hunks)
🧰 Additional context used
🪛 Gitleaks (8.27.2)
self-hosting/methods/docker-aio.mdx

78-78: Detected a Generic API Key, potentially exposing access to various services and sensitive operations.

(generic-api-key)

🔇 Additional comments (1)
mint.json (1)

70-76: Verify navigation ordering & slug consistency

The new slugs ​self-hosting/methods/docker-aio​ and the moved ​airgapped-edition​ entry look correct, but please run the site locally to ensure:

  1. The new page renders (front-matter slug matches filename).
  2. The reorder does not break deep links that previously referenced the old position.

No change requested if both checks pass.

Comment on lines +38 to +41
1. [Download the image]

2. Run the following command to deploy the Plane AIO container. Make sure to replace all placeholder values (e.g., `your-domain.com`, `user:pass`) with your actual configuration.

Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue

Broken placeholder link

[Download the image] is currently an empty Markdown reference. Readers will hit a 404 or be confused.
Replace with the actual download URL or convert it to plain text until a link is available.

🤖 Prompt for AI Agents
In self-hosting/methods/docker-aio.mdx around lines 38 to 41, the Markdown link
labeled [Download the image] is a broken placeholder with no URL, causing
confusion or 404 errors. Replace the empty Markdown reference with the actual
download URL for the image if available, or convert the text to plain text
without a link until a valid URL can be provided.

Comment on lines +77 to +78
-e AWS_ACCESS_KEY_ID=5MV45J9NF5TEFZWYCRAX \
-e AWS_SECRET_ACCESS_KEY=7xMqAiAHsf2UUjMH+EwICXlyJL9TO30m8leEaDsL \
Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue

Remove real-looking AWS credentials

These lines contain hard-coded access keys that triggered gitleaks:

-e AWS_ACCESS_KEY_ID=5MV45J9NF5TEFZWYCRAX
-e AWS_SECRET_ACCESS_KEY=7xMqAiAHsf2UUjMH+EwICXlyJL9TO30m8leEaDsL

Even if they are fictitious, publishing realistic-length secrets teaches bad practice and may be blocked by automated scanners. Replace with unmistakable placeholders, e.g.:

- -e AWS_ACCESS_KEY_ID=5MV45J9NF5TEFZWYCRAX
- -e AWS_SECRET_ACCESS_KEY=7xMqAiAHsf2UUjMH+EwICXlyJL9TO30m8leEaDsL
+ -e AWS_ACCESS_KEY_ID=<YOUR_AWS_ACCESS_KEY_ID>
+ -e AWS_SECRET_ACCESS_KEY=<YOUR_AWS_SECRET_ACCESS_KEY>
🧰 Tools
🪛 Gitleaks (8.27.2)

78-78: Detected a Generic API Key, potentially exposing access to various services and sensitive operations.

(generic-api-key)

🤖 Prompt for AI Agents
In self-hosting/methods/docker-aio.mdx at lines 77 to 78, the AWS credentials
are hard-coded with realistic-looking values, which can trigger security
scanners like gitleaks. Replace these values with clear placeholder text such as
AWS_ACCESS_KEY_ID=YOUR_ACCESS_KEY_ID and
AWS_SECRET_ACCESS_KEY=YOUR_SECRET_ACCESS_KEY to avoid exposing sensitive
information and to follow best practices.

Comment on lines +123 to +127
- `SECRET_KEY`: Django secret key (default provided)
- `SILO_HMAC_SECRET_KEY`: Silo HMAC secret (default provided)
- `AES_SECRET_KEY`: AES encryption key (default provided)
- `LIVE_SERVER_SECRET_KEY`: Live server secret (default provided)

Copy link

Choose a reason for hiding this comment

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

🛠️ Refactor suggestion

Warn readers to rotate default secrets

The doc states “default provided” for SECRET_KEY, SILO_HMAC_SECRET_KEY, etc. Strongly advise users to set their own values; otherwise many installations will share identical secrets, undermining security. Add an explicit call-out or <Warning> block instructing them to override every secret in production.

🤖 Prompt for AI Agents
In self-hosting/methods/docker-aio.mdx around lines 123 to 127, the
documentation lists default secret keys without warning users to change them.
Add a clear warning or <Warning> block emphasizing that users must replace all
default secret keys like SECRET_KEY, SILO_HMAC_SECRET_KEY, AES_SECRET_KEY, and
LIVE_SERVER_SECRET_KEY with unique values in production to avoid security risks
from shared secrets.

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.

1 participant