Files
proxmox-api-simulator/docs/faq.md
T
Sergey Antropoff 777926487b Add a stateful Proxmox API console and broad handler coverage beyond the
initial QEMU slice, backed by imported contracts for majors 6–9.
- Implement durable handlers for access/auth, cluster, LXC, storage, HA,
  firewall, Ceph, SDN, ACME, notifications, pools, mapping, and node ops
- Serve an interactive Web UI with catalog browsing, demo seed controls,
  and OpenAPI/help surfaces
- Bundle PVE 6.4-15, 7.4-16, and 8.4.5 contract revisions alongside 9.2.3
- Support in-memory runtime contract Apply (POST /ui/api/contract/apply)
  so /version and /api2 routes follow the selected major until restart
- Expand seed profiles (including demo-cluster), migrations 007–008, TLS
  gateway config, Compose/Makefile tooling, and compatibility evidence
- Tighten .gitignore for macOS, hidden directories (.*/), and local secrets
2026-07-16 01:08:01 +03:00

1.5 KiB
Raw Blame History

FAQ

Is this a real Proxmox hypervisor?

No. It is an API and state simulator. Guests, storages, Ceph, and HA are durable PostgreSQL models, not KVM/LXC processes.

Do you really cover API versions 6, 7, 8, and 9?

Yes — 100% of declared methods for each bundled major have registered semantic handlers. Switch majors via cold-start snapshot or runtime hot-swap. See API versions and Compatibility.

Can I use this in CI for Terraform / Ansible / custom clients?

Yes. That is a primary use case. Pin the API major, seed a profile, and point clients at HTTP :8006 or HTTPS :8007. See Clients.

Why do some OpenID / LDAP / ACME / Ceph calls “succeed” without remotes?

Those domains persist local simulator state. They intentionally do not call real external systems.

Does registry coverage mean perfect Proxmox parity?

It means every declared route has a durable handler and is subject to the projects verification suites for majors 69. Exact edge-case parity with a physical cluster can still differ; use evidence endpoints and your own client tests for certification claims.

Where is the Web UI?

http://localhost:8006/ after make up.

Can I deploy on Kubernetes?

Yes. Use the Helm chart under helm/proxmox-api-simulator with the published Hub image. Ingress + cert-manager Let's Encrypt is supported — see Kubernetes / Helm.

Which node name does the small seed use?

pve01.