apache / apache/cloudstack

Encountered issues when attempting to bootstrap CloudStack with Proxmox

Open
#12,363 0 comments 3 reactions 0 assignees View on GitHub
component:extensions type:improvement
Dominant language
Java
Stars
3.1k
Forks
1.4k
Avg merge
6d 19h
Merged PRs (30d)
32

Description

### problem

### Discussed in https://github.com/apache/cloudstack/discussions/12273

Originally posted by **ShadowJonathan** December 16, 2025
Here are a few things I encountered while attempting to install/add Proxmox to cloudstack;

I then attempted to install a new zone, with the following zone-wide settings:
image
I could only select "external", not proxmox or the likes.

I realise the zone was disabled, enable it, and recreate the VM, which gets me this error:

image

Looking at the logs, it gives me this:

```
2025-12-16 18:18:29,159 ERROR [c.c.v.ClusteredVirtualMachineManagerImpl] (Work-Job-Executor-10:[ctx-ca2a9424, job-49/job-51, ctx-8cb0346d]) (logid:ce949871) Unable to orchestrate start VM instance {"id":3,"instanceName":"i-2-3VM","state":"Stopped","type":"User","uuid":"53f4a94c-3124-4368-952e-7da10c9f472f"} due to [Cannot find an available cluster in Pod 2 to start domain router for Ovm.
Ovm won't support any system vm including domain router, please make sure you have a cluster with hypervisor type of any of xenserver/KVM/Vmware in the same pod with Ovm cluster. And there is at least one host in UP status in that cluster.].
```

### versions

The versions of ACS, hypervisors, storage, network etc..

### The steps to reproduce the bug

1.
2.
3.
...

### What to do about it?

'External' as a hypervisor option should not be shown in the Zone creation wizard, as a primary hypervisor (kvm, vmware and xenserver) to run the systemvms.
Also update the documentation if it is not clear enough.

Contributor guide

Open the contributing guide

Research direction

Start with the zone creation wizard and the hypervisor-selection behavior described in the issue, then trace the system-VM orchestration error for OVM in the provided logs. Review the CloudStack documentation covering external hypervisors and system VMs. Done means the wizard no longer offers the invalid primary hypervisor choice and the documentation clearly explains the supported setup.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
cloud, infrastructure
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.