Skip to content

Add Azure AKS Enterprise installation documentation - #871

Open
rajshah4 wants to merge 9 commits into
mainfrom
codex/azure-aks-docs
Open

rajshah4 wants to merge 9 commits into
mainfrom
codex/azure-aks-docs

Conversation

@rajshah4

@rajshah4 rajshah4 commented Oct 2, 2026 •

Copy link
Copy Markdown
Member

Adds an Azure AKS installation guide using the evaluated standard runc configuration, and notes that Sysbox is not yet supported for OpenHands Enterprise on AKS. Documents the Helm overrides, Docker and isolation limits, ready-capacity requirements, cold-start failures and unresolved resume/maintenance issues.

Validated on chart 0.74.0 / OpenHands 1.67.0: ordinary coding/browser workflows and persistence passed. Six warm starts and three starts on the same cached node passed; three cold starts exceeded the startup deadline. Automations and PVC expansion were not validated on the runc rebuild.

Validation: Mintlify build and broken-link checks, navigation JSON, Bash syntax and whitespace checks passed. The previous draft received a two-pass Opus 5.5 review; a final review of this PR diff against the related installation guides is in progress. Custom LLM indexes were removed to follow current repository policy.

@mintlify

mintlify Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
all-hands-ai 🟢 Ready View Preview Oct 8, 2026, 12:38 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@enyst enyst left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I'm an AI agent based on Opus 5.5, helping Engel Nyst (@enyst) with project work.

  • Rebase: main removed llms.txt and llms-full.txt in #815 (Mintlify generates them now), so dropping those two files from this PR clears the conflict. #875 edits the same docs.json line.
  • The skill links, and the Sysbox workaround that the Warning points readers to, exist only in OpenHands-Cloud#1339, which is still open. I'd merge that first and point lines 50, 75 and 144–145 at main (see inline).
  • Checked: the chart's filestore supports only S3-compatible stores and GCS (values.yaml#L145-L148), and nestybox/sysbox#997 matches the containerd 2.x symptom.
  • Style: much of the page reads like a test report ("The evaluation used…"). You could state each recommendation directly, as the EKS page does, and move the tested versions into one "Validated with" note like the one in #875.
  • Optional: add an Azure AKS card next to Amazon EKS in enterprise/k8s-install/index.mdx.

Comment thread enterprise/k8s-install/aks.mdx Outdated
[AKS installation skill](https://github.com/OpenHands/OpenHands-Cloud/blob/832e57028298f3ad564e6ee7461ee1d9d2ee6d62/.agents/skills/aks-install.md)
and [companion files](https://github.com/OpenHands/OpenHands-Cloud/tree/832e57028298f3ad564e6ee7461ee1d9d2ee6d62/aks-install)
provide Azure commands, values templates and storage/automation checks.
The skill is currently proposed in [PR #1339](https://github.com/OpenHands/OpenHands-Cloud/pull/1339).

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

OpenHands-Cloud#1339 is still open, so these links (and the ones on lines 50, 75 and 144–145) go to an unmerged commit. Once it merges, I'd point them at main and drop this sentence.

@rajshah4
rajshah4 marked this pull request as ready for review October 8, 2026 12:25

This branch was successfully deployed

1 active deployment
staging — 71556318 Deployed Oct 8, 2026 by mintlify[bot]
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