Pertisk

AlphaLab · open source

Pertisk VMs

QEMU/KVM control plane — API, CLI, and UI.

Pertisk VMs is a Proxmox-style control plane without SSH for day-to-day work. Operators use REST /v1, the pertisk CLI, or the React UI to create guests, clone cloud templates, import ISOs, join a quorum cluster, and export inventory as Terraform HCL. Linux defaults to QEMU + OVMF so Pertisk KOS UEFI cloud images boot; macOS stays on a mock driver. Live CPU/memory/network charts stream in the UI. KOS mgmt registers the daemon as kind pertisk-vms and streams qcow2 over HTTPS.

DocumentationGitHub repositoryRelease notesLive demoAll projects
Pertisk VMs redesigned datacenter overview with live CPU, memory, and network charts

Highlights

  • HTTP API + web UI + CLI — no SSH for VM ops
  • Cloud templates, clone + cloud-init, live metrics charts
  • Terraform export (provider, templates, VMs, networks)
  • Node updates, apt repos, and a root host shell

Stack

  • Rust
  • QEMU / OVMF
  • Cloud Hypervisor
  • Axum
  • React UI

Management UI

Hash routes on the live demo. Roles: viewer (read), operator (mutate), admin (users).

Login

/#/login

Username/password, stay signed in.

  • Sign in

Overview

/#/dc/summary

Guests live, nodes, quorum, volumes, live charts.

  • Create guest
  • Open a guest

Templates

/#/dc/templates

Cloud images used as clone sources.

  • Import image
  • From volume
  • Clone
  • Destroy

Storage

/#/dc/storage

Replica volumes, ISO import, cloud-init seed ISOs.

  • Create volume
  • Import ISO
  • Cloud-init

Networks

/#/dc/networks

NAT or bridged networks (vmbr0 / br0).

  • Create network

Cluster

/#/dc/cluster

Members, generation, quorum, fenced state.

  • Join cluster
  • Leave

Terraform

/#/dc/terraform

Provider HCL, template clone example, inventory snapshot.

  • Copy
  • Download main.tf

Node summary

/#/node/:id/summary

Host status, addresses, live metrics.

  • Refresh

Node updates

/#/node/:id/updates

apt refresh / dist-upgrade on the hypervisor.

  • Refresh
  • Upgrade

Node shell

/#/node/:id/shell

Root terminal on this hypervisor.

  • Type in the shell

Users

/#/dc/users

Local accounts: admin, operator, viewer.

  • Create user

Screenshots

Pertisk VMs sign-in
Pertisk VMs sign-in
Datacenter overview with live CPU, memory, disk, and network charts
Datacenter overview with live CPU, memory, disk, and network charts
Cluster members, generation, and join
Cluster members, generation, and join
Terraform export: provider setup, template clone, generated HCL
Terraform export: provider setup, template clone, generated HCL
Cloud templates catalog with Clone and Import image
Cloud templates catalog with Clone and Import image
Clone template wizard with cloud-init guest step
Clone template wizard with cloud-init guest step
Create guest wizard
Create guest wizard
Running guest summary with live metrics charts
Running guest summary with live metrics charts
Graphics console Display tab on a running AlmaLinux guest
Graphics console Display tab on a running AlmaLinux guest
Guest hardware: memory, vCPU, disks, CD-ROM, and NICs
Guest hardware: memory, vCPU, disks, CD-ROM, and NICs
Guest HA and start-at-boot options
Guest HA and start-at-boot options
Node summary with live host metrics
Node summary with live host metrics
Node updates Refresh and Upgrade
Node updates Refresh and Upgrade
Node apt repositories
Node apt repositories
Web UI root shell on the hypervisor node
Web UI root shell on the hypervisor node
pertisk-vm host console MOTD with LAN IP and root shell
pertisk-vm host console MOTD with LAN IP and root shell
pertisk-tui guest list with CPU, memory, disk, and power keys
pertisk-tui guest list with CPU, memory, disk, and power keys
Volumes, ISO import, and cloud-init
Volumes, ISO import, and cloud-init
NAT and bridged networks
NAT and bridged networks
Task history
Task history
Users with admin, operator, and viewer roles
Users with admin, operator, and viewer roles

Clone

git clone https://github.com/pertisktech/pertisk-vms.git