[Cloudflare One] Document self-serve Cloudflare One Virtual Appliance downloads - #32915
Merged
nikitacano merged 3 commits intoAug 24, 2026
Merged
Conversation
Update the connector configuration partial so the Cloudflare One Virtual Appliance is documented as self-serve across VMware ESXi (OVA image), Proxmox (VM helper script), and a new libvirt/KVM (beta) tab. License keys are now generated self-serve from the Connectors page. Co-authored-by: OpenCode <noreply@opencode.ai> Co-authored-by: Build <noreply@cloudflare.com> Co-authored-by: Anthropic <noreply@anthropic.com> Co-authored-by: claude-opus-4-8 <noreply@anthropic.com>
nikitacano
marked this pull request as ready for review
August 21, 2026 13:23
nikitacano
requested review from
a team,
alpdot,
jeffh-cloudflare and
steve-cloudflare
as code owners
August 21, 2026 13:23
Contributor
Review
👉 Fix in your agent 👈Fix the following review findings in PR #32915 (https://github.com/cloudflare/cloudflare-docs/pull/32915).
Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification
- If you disagree (e.g. the fix requires disproportionate effort for minimal benefit,
or the finding is factually incorrect), explain why
- If you need clarification before deciding, ask those questions
- Then share your plan for which issues to tackle and in what order
After triaging, follow this order:
1. Post a comment on this PR for any findings you are skipping, with the finding ID and your reasoning.
2. Then commit the fixes for the legitimate findings.
The comment must come before the commit — the bot reads PR comments when a new
push triggers a review, so skip comments posted after the push will be missed.
---
## Conventions
### Warnings (1)
#### CV-90746e7826d3 · Scope accuracy
- **File:** PR-level finding
- **Issue:** The PR adds a new changelog entry (src/content/changelog/cloudflare-wan/2026-08-24-virtual-appliance-self-serve-download.mdx, +20 lines) and a matching image (src/assets/images/changelog/cloudflare-wan/2026-08-24-virtual-appliance-self-serve-download.png), yet the description never mentions these and the checklist explicitly states 'Is there a changelog entry? — N/A' as if no changelog entry were added.
- **Fix:** Mention the new changelog entry and image in the description, and correct the checklist item that currently claims a changelog entry is N/A.
---
## Style Guide Review
### Warnings (1)
#### SG-dbd6d7fc7953 · Bulleted list used for sequential steps
- **File:** `src/content/changelog/cloudflare-wan/2026-08-24-virtual-appliance-self-serve-download.mdx` line 14
- **Issue:** Lines 14–16 describe a sequential procedure (select hypervisor, download image/script, open setup guide) using bullet points.
- **Fix:** Use a numbered list for this procedure, since the steps must be performed in order.
Code ReviewThis code review is in beta and may not always be helpful — use your judgment. No code review issues found. ConventionsWarnings (1)
Style Guide ReviewWarnings (1)
CommandsOnly codeowners can run commands. Post a comment with the command to trigger it.
|
Contributor
|
This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:
|
🚀 Deploying Preview to Cloudflare 🚀Preview URL: https://ncano-mconn-1410-virtual-appliance-ova-download-cloudflare-docs.cloudflare-docs.workers.dev (commit a996b75)This URL reflects your latest Preview deploymentPreview Deployments by commit
|
Contributor
|
Please consider replacing the string "VMWare" with "VMware". The latter is the standard capitalization of the VMware brand. |
Announce selecting a hypervisor (VMware ESXi, Proxmox, libvirt/KVM) and downloading the Cloudflare One Virtual Appliance image or install script directly from the Connectors page. Co-authored-by: OpenCode <noreply@opencode.ai> Co-authored-by: Build <noreply@cloudflare.com> Co-authored-by: Anthropic <noreply@anthropic.com> Co-authored-by: claude-opus-4-8 <noreply@anthropic.com>
nikitacano
enabled auto-merge (squash)
August 24, 2026 11:06
kennyj42
reviewed
Aug 24, 2026
|
|
||
| This complements the existing self-serve [registration and license key generation](/cloudflare-wan/configuration/appliance/configure-virtual-appliance/#register-a-virtual-appliance-and-generate-a-license-key) in the dashboard. | ||
|
|
||
| For details, refer to [Configure a Cloudflare One Virtual Appliance](/cloudflare-wan/configuration/appliance/configure-virtual-appliance/#configure-a-virtual-machine). |
Collaborator
There was a problem hiding this comment.
do you want something like "don't see your hypervisor listed? stay tuned for more support" or are these the majority?
kennyj42
reviewed
Aug 24, 2026
| { props.magicWord === "virtual" && ( | ||
| <> | ||
| <p>{props.productNameVirtual} is a virtual device alternative to the hardware based {props.productName}. These two versions of {props.productName} are identical otherwise.</p> <p>Currently, you can set up {props.productNameVirtual} on VMWare ESXi and Proxmox Virtual Environment. Support for Proxmox is in beta.</p> | ||
| <p>{props.productNameVirtual} is a virtual device alternative to the hardware based {props.productName}. These two versions of {props.productName} are identical otherwise.</p> <p>Currently, you can set up {props.productNameVirtual} on VMware ESXi and Proxmox Virtual Environment. Support for Proxmox is in beta.</p> |
Collaborator
There was a problem hiding this comment.
Is this the pattern we use for "beta" or should it be a badge or warning callout?
@kodster28 this could be a good linter thing
kennyj42
reviewed
Aug 24, 2026
| 10. Before completing the deployment wizard, disable **Power on automatically**. This is important so that you can configure the license key prior to boot. | ||
|
|
||
| 11. Configure the virtual machine with the license key your account team provided you: | ||
| 11. Configure the virtual machine with the license key you generated: |
Collaborator
There was a problem hiding this comment.
best line in the whole pr
kennyj42
reviewed
Aug 24, 2026
|
|
||
| Download the ${props.productNameVirtual} helper script for libvirt/KVM to your host. The script deploys the virtual machine with the appropriate settings for ${props.productNameVirtual}. For details on system requirements, refer to [Prerequisites](#prerequisites). | ||
|
|
||
| The deployment assumes the use of libvirt. The virtual machine manager graphical interface is not required. The VM uses the \`OVMF_CODE.fd\` file from the \`ovmf\` package on Debian or Ubuntu. |
Collaborator
There was a problem hiding this comment.
do you want a hyperlink to libvirt docs or anything like that if the user isn't sure what that is?
kennyj42
approved these changes
Aug 24, 2026
rpots
pushed a commit
that referenced
this pull request
Aug 28, 2026
… downloads (#32915) * Document self-serve Cloudflare One Virtual Appliance downloads Update the connector configuration partial so the Cloudflare One Virtual Appliance is documented as self-serve across VMware ESXi (OVA image), Proxmox (VM helper script), and a new libvirt/KVM (beta) tab. License keys are now generated self-serve from the Connectors page. Co-authored-by: OpenCode <noreply@opencode.ai> Co-authored-by: Build <noreply@cloudflare.com> Co-authored-by: Anthropic <noreply@anthropic.com> Co-authored-by: claude-opus-4-8 <noreply@anthropic.com> * VMWare > VMware * Add changelog for self-serve virtual appliance download Announce selecting a hypervisor (VMware ESXi, Proxmox, libvirt/KVM) and downloading the Cloudflare One Virtual Appliance image or install script directly from the Connectors page. Co-authored-by: OpenCode <noreply@opencode.ai> Co-authored-by: Build <noreply@cloudflare.com> Co-authored-by: Anthropic <noreply@anthropic.com> Co-authored-by: claude-opus-4-8 <noreply@anthropic.com> --------- Co-authored-by: OpenCode <noreply@opencode.ai> Co-authored-by: Build <noreply@cloudflare.com> Co-authored-by: Anthropic <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
6 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates the shared MCONN connector configuration partial so the Cloudflare One Virtual Appliance is documented as self-serve across all supported hypervisors:
mconn.ova) plus the existing dashboard download path.proxmox_mconn_vm.sh); steps renumbered.libvirt_mconn_vm.shhelper script, with prompts for name/storage pool/console/license and macvtap NIC guidance.licence-keyspartial).All asset URLs are public (no auth). Product name is rendered via the existing
productNameVirtualprop ("Cloudflare One Virtual Appliance"). The Proxmox container (CT) flow is intentionally excluded as it remains internal-only.Affects the four pages that render this partial (Cloudflare WAN + Cloudflare One appliance configuration pages).
Documentation checklist