Skip to content

docs: add Azure VM Replicated quick start - #878

Open
rajshah4 wants to merge 3 commits into
codex/split-enterprise-vm-quick-startfrom
codex/azure-replicated-quick-start
Open

rajshah4 wants to merge 3 commits into
codex/split-enterprise-vm-quick-startfrom
codex/azure-replicated-quick-start

Conversation

@rajshah4

@rajshah4 rajshah4 commented Oct 3, 2026 •

Copy link
Copy Markdown
Member

Adds an Azure VM quick start for installing OpenHands Enterprise with Replicated Embedded Cluster and configuring Anthropic through the Replicated Admin Console. Covers Azure networking and persistent disk provisioning, disk latency preflights, DNS/TLS, GitHub authentication, first-conversation validation and cleanup. Adds navigation and a legacy quick-start link.

The VM install and Anthropic workflow were validated on Replicated 0.74.0: host/application preflights without overrides, trusted HTTPS, GitHub login, persistent PostgreSQL storage, a terminal-backed conversation, a manually dispatched automation and a read-only repository conversation. Backup/restore, multiple nodes and automatic certificate renewal were not tested. Replicated 0.76.0 was not installed for this validation.

Azure OpenAI gateway setup is deferred until the provider fix is released and the released package is validated. This VM installation is separate from the AKS/Sysbox issue. The revised page removes the unreleased Azure test-package instructions and follows current main policy by removing generated LLM files.

Based on #877; merge #876 and #877 first.

Validation: Mintlify broken-link check and strict build validation, navigation JSON, all 15 Bash examples and git diff --check passed. Independent Claude Opus 5.5 review through Agent Canvas completed before publication.

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

Two things need fixing before merge:

  • Drop the llms.txt / llms-full.txt changes. #815 removed both files from main because Mintlify now generates them, and AGENTS.md says not to commit files at those paths. Once this PR is retargeted, both files conflict (modify/delete). Resolving the conflict by keeping them would override the generated files.
  • The Azure OpenAI section documents an unmerged fix. OpenHands-Cloud#1337 is still open. The published openhands/0.75.0 and 0.76.0 releases, and OpenHands-Cloud main, still route api_version through os.environ/AZURE_API_VERSION (0.76.0 openhands.yaml#L947). So "release 1749 / OpenHands 0.75.0 fixes this" will mislead anyone running the official 0.75.0. Azure Providers and Azure AI Foundry exist only on #1337's head (config.yaml#L466). I'd keep a short warning that Azure OpenAI managed routes are affected in current releases, and add the setup steps once a release with the fix ships.

Non-blocking: this is the third copy of the preflight, installer, and configure flow (see my note on #877 about shared snippets). The Validation Scope section has the same test-log tone I mentioned on #876.

@rajshah4
rajshah4 marked this pull request as draft October 4, 2026 22:37
@rajshah4 rajshah4 changed the title docs: add Azure Replicated quick start docs: add Azure VM Replicated quick start Oct 5, 2026
@rajshah4
rajshah4 marked this pull request as ready for review October 5, 2026 20:44

This branch has not been deployed

No deployments
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