Skip to content

Enhance Docker instructions across multiple quick start guides - #405

Merged
Arshardh merged 3 commits into
wso2:mainfrom
Arshardh:qsg-update
Aug 4, 2026
Merged

Enhance Docker instructions across multiple quick start guides#405
Arshardh merged 3 commits into
wso2:mainfrom
Arshardh:qsg-update

Conversation

@Arshardh

@Arshardh Arshardh commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

This PR updates the Compose-based quick-start docs to better cover local runtime and startup issues.

It:

  • adds Compose-compatible runtime guidance, including Podman, while keeping the examples based on docker compose
  • adds port-conflict troubleshooting for local startup, including how to identify processes already using the default ports and when to remap host ports
  • simplifies the runtime verification wording so the prerequisite section stays concise
  • fixes tip block indentation so the port-conflict guidance renders correctly inside the admonition

Scope
The update covers:

  • AI Workspace getting started
  • API Gateway quick starts
  • AI Gateway LLM proxy quick starts
  • AI Gateway MCP proxy quick starts
  • Cloud AI Gateway quick starts
Screenshot 2026-08-04 at 18 31 08 Screenshot 2026-08-04 at 18 31 16

@coderabbitai

coderabbitai Bot commented Aug 4, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@Arshardh, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 52 minutes

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 5b0e06e2-f68b-4e98-aa21-a390c055aec1

📥 Commits

Reviewing files that changed from the base of the PR and between cc6b22b and b5ed729.

📒 Files selected for processing (12)
  • en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md
  • en/docs/ai-gateway/1.0.0/mcp-proxy/quick-start-guide.md
  • en/docs/ai-gateway/1.1.0/llm-proxy/quick-start-guide.md
  • en/docs/ai-gateway/1.1.0/mcp-proxy/quick-start-guide.md
  • en/docs/ai-gateway/next/llm-proxy/quick-start-guide.md
  • en/docs/ai-gateway/next/mcp-proxy/quick-start-guide.md
  • en/docs/api-gateway/1.0.0/quick-start-guide.md
  • en/docs/api-gateway/1.1.0/quick-start-guide.md
  • en/docs/api-gateway/next/quick-start-guide.md
  • en/docs/cloud/ai-gateway/llm/quick-start-guide.md
  • en/docs/cloud/ai-gateway/mcp/quick-start-guide.md
  • en/docs/next/ai-workspace/getting-started.md
📝 Walkthrough

Walkthrough

The quick-start guides update metadata dates, support Podman and other Compose-compatible runtimes, verify runtime commands, and add troubleshooting for occupied ports and host-port remapping.

Changes

Runtime and port guidance

Layer / File(s) Summary
Runtime prerequisites and metadata
en/docs/ai-gateway/*/quick-start-guide.md, en/docs/api-gateway/*/quick-start-guide.md, en/docs/cloud/ai-gateway/*/quick-start-guide.md, en/docs/next/ai-workspace/getting-started.md
The guides add Podman and equivalent Compose command guidance. They add runtime command verification and update document dates.
Port-conflict troubleshooting
en/docs/ai-gateway/*/quick-start-guide.md, en/docs/api-gateway/*/quick-start-guide.md, en/docs/cloud/ai-gateway/*/quick-start-guide.md, en/docs/next/ai-workspace/getting-started.md
The guides document listener inspection, stopping conflicting services, host-port remapping, and updates to later commands or URLs.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested reviewers: anugayan, selectiveduplicate

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description clearly summarizes the changes and scope but omits most required template sections, including the checklist, testing, security, release, and related-content details. Complete the required template sections and provide applicable checklist, testing, security, release, documentation, training, certification, and environment details.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the main documentation change across multiple quick-start guides.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md`:
- Around line 69-77: The port troubleshooting blocks provide only lsof commands
and need Windows guidance. Add PowerShell port-inspection instructions for ports
8080, 8443, 9090, and 9094 in
en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md:69-77,
en/docs/ai-gateway/1.0.0/mcp-proxy/quick-start-guide.md:68-76,
en/docs/ai-gateway/1.1.0/llm-proxy/quick-start-guide.md:69-77,
en/docs/ai-gateway/1.1.0/mcp-proxy/quick-start-guide.md:68-76,
en/docs/ai-gateway/next/llm-proxy/quick-start-guide.md:79-87,
en/docs/ai-gateway/next/mcp-proxy/quick-start-guide.md:78-86,
en/docs/api-gateway/1.0.0/quick-start-guide.md:60-68,
en/docs/api-gateway/1.1.0/quick-start-guide.md:102-110,
en/docs/api-gateway/next/quick-start-guide.md:112-120,
en/docs/cloud/ai-gateway/llm/quick-start-guide.md:57-65, and
en/docs/cloud/ai-gateway/mcp/quick-start-guide.md:58-66. Add equivalent Windows
instructions for ports 9643 and 9243 in
en/docs/next/ai-workspace/getting-started.md:70-76, using Get-NetTCPConnection
or explicitly directing readers to WSL or Git Bash.
- Line 79: Split the port-remapping sentence into short sentences under 26
words, change “host side” to “host-side,” and preserve the existing
instructions. Apply this change at
en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md:79-79,
en/docs/ai-gateway/1.0.0/mcp-proxy/quick-start-guide.md:78-78,
en/docs/ai-gateway/1.1.0/llm-proxy/quick-start-guide.md:79-79,
en/docs/ai-gateway/1.1.0/mcp-proxy/quick-start-guide.md:78-78,
en/docs/ai-gateway/next/llm-proxy/quick-start-guide.md:89-89,
en/docs/ai-gateway/next/mcp-proxy/quick-start-guide.md:88-88,
en/docs/api-gateway/1.0.0/quick-start-guide.md:70-70,
en/docs/api-gateway/1.1.0/quick-start-guide.md:112-112,
en/docs/api-gateway/next/quick-start-guide.md:122-122,
en/docs/cloud/ai-gateway/llm/quick-start-guide.md:67-67,
en/docs/cloud/ai-gateway/mcp/quick-start-guide.md:68-68, and
en/docs/next/ai-workspace/getting-started.md:78-78.

In `@en/docs/ai-gateway/1.0.0/mcp-proxy/quick-start-guide.md`:
- Around line 38-45: Document the Docker-specific network requirement in the
quick-start guidance at en/docs/ai-gateway/1.0.0/mcp-proxy/quick-start-guide.md
lines 38-45, en/docs/ai-gateway/1.1.0/mcp-proxy/quick-start-guide.md lines
38-45, en/docs/ai-gateway/next/mcp-proxy/quick-start-guide.md lines 38-45, and
en/docs/cloud/ai-gateway/mcp/quick-start-guide.md lines 26-33. Either provide
the supported Podman/Compose-compatible commands and explain the resulting
network name used by docker run --network with the ai-gateway project, or
clearly limit the docker compose prerequisite and dependent network steps to
Docker users.
🪄 Autofix

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: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 4f55f5c6-fbca-4ff9-9c8c-fc41649ad9c2

📥 Commits

Reviewing files that changed from the base of the PR and between 5f055af and e918f40.

📒 Files selected for processing (12)
  • en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md
  • en/docs/ai-gateway/1.0.0/mcp-proxy/quick-start-guide.md
  • en/docs/ai-gateway/1.1.0/llm-proxy/quick-start-guide.md
  • en/docs/ai-gateway/1.1.0/mcp-proxy/quick-start-guide.md
  • en/docs/ai-gateway/next/llm-proxy/quick-start-guide.md
  • en/docs/ai-gateway/next/mcp-proxy/quick-start-guide.md
  • en/docs/api-gateway/1.0.0/quick-start-guide.md
  • en/docs/api-gateway/1.1.0/quick-start-guide.md
  • en/docs/api-gateway/next/quick-start-guide.md
  • en/docs/cloud/ai-gateway/llm/quick-start-guide.md
  • en/docs/cloud/ai-gateway/mcp/quick-start-guide.md
  • en/docs/next/ai-workspace/getting-started.md

Comment thread en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md
Comment thread en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md Outdated
Comment thread en/docs/ai-gateway/1.0.0/mcp-proxy/quick-start-guide.md
Krishanx92
Krishanx92 previously approved these changes Aug 4, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

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 current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md`:
- Line 11: Update the last_updated metadata to the actual content update or
publication date, ensuring no value is future-dated. Apply this correction in
en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md:11,
en/docs/ai-gateway/1.0.0/mcp-proxy/quick-start-guide.md:11,
en/docs/ai-gateway/1.1.0/llm-proxy/quick-start-guide.md:11,
en/docs/ai-gateway/1.1.0/mcp-proxy/quick-start-guide.md:11,
en/docs/ai-gateway/next/llm-proxy/quick-start-guide.md:11,
en/docs/ai-gateway/next/mcp-proxy/quick-start-guide.md:11,
en/docs/api-gateway/1.0.0/quick-start-guide.md:11,
en/docs/api-gateway/1.1.0/quick-start-guide.md:11,
en/docs/api-gateway/next/quick-start-guide.md:11,
en/docs/cloud/ai-gateway/llm/quick-start-guide.md:12,
en/docs/cloud/ai-gateway/mcp/quick-start-guide.md:12, and
en/docs/next/ai-workspace/getting-started.md:11.
- Around line 72-85: Indent the entire port troubleshooting block consistently
by four spaces so the platform labels, fenced code blocks, commands, and closing
fences remain inside the tip block. Apply this to
en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md:72-85,
en/docs/ai-gateway/1.0.0/mcp-proxy/quick-start-guide.md:71-84,
en/docs/ai-gateway/1.1.0/llm-proxy/quick-start-guide.md:72-85,
en/docs/ai-gateway/1.1.0/mcp-proxy/quick-start-guide.md:71-84,
en/docs/ai-gateway/next/llm-proxy/quick-start-guide.md:82-95,
en/docs/ai-gateway/next/mcp-proxy/quick-start-guide.md:81-94,
en/docs/api-gateway/1.0.0/quick-start-guide.md:63-76,
en/docs/api-gateway/1.1.0/quick-start-guide.md:105-118,
en/docs/api-gateway/next/quick-start-guide.md:115-128,
en/docs/cloud/ai-gateway/llm/quick-start-guide.md:60-73, and
en/docs/cloud/ai-gateway/mcp/quick-start-guide.md:61-74.
🪄 Autofix

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: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 156c7eb6-195d-419d-ab18-2c3ddf856cfa

📥 Commits

Reviewing files that changed from the base of the PR and between e918f40 and cc6b22b.

📒 Files selected for processing (12)
  • en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md
  • en/docs/ai-gateway/1.0.0/mcp-proxy/quick-start-guide.md
  • en/docs/ai-gateway/1.1.0/llm-proxy/quick-start-guide.md
  • en/docs/ai-gateway/1.1.0/mcp-proxy/quick-start-guide.md
  • en/docs/ai-gateway/next/llm-proxy/quick-start-guide.md
  • en/docs/ai-gateway/next/mcp-proxy/quick-start-guide.md
  • en/docs/api-gateway/1.0.0/quick-start-guide.md
  • en/docs/api-gateway/1.1.0/quick-start-guide.md
  • en/docs/api-gateway/next/quick-start-guide.md
  • en/docs/cloud/ai-gateway/llm/quick-start-guide.md
  • en/docs/cloud/ai-gateway/mcp/quick-start-guide.md
  • en/docs/next/ai-workspace/getting-started.md

Comment thread en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md
Comment thread en/docs/ai-gateway/1.0.0/llm-proxy/quick-start-guide.md
@Arshardh
Arshardh merged commit c4bf819 into wso2:main Aug 4, 2026
2 checks passed
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