How mortal2424/proxmox-billing-pub works
Proxmox Billing is a web panel for provisioning virtual machines and containers, charging users for resources, and monitoring Proxmox infrastructure. The main user journey is to choose a tariff, order a VM or container, then manage it and view usage; administrators configure clusters and nodes, while scheduled jobs handle billing and metric collection. The README documents support tickets and email/Telegram notifications as additional capabilities. Some subsystem links rely on README descriptions or SOURCE INDEX references; unsampled implementation details are not inferred.
Main entry points: db.php Application database · proxmox_functions.php Proxmox operations · index.php Admin console · collect_vm_metrics.php Metric collection
Components 20
Accounts and portal
- Tariff catalog
index.php - Registration
login/register.php - User VM portal
templates/my_vms.php - Session auth
includes/auth.php
Proxmox provisioning
- Admin console
admin/index.php - Cluster and node setup
admin/add_cluster.php - VM ordering
templates/order_vm.php - Proxmox operations
includes/proxmox_functions.php
Billing and monitoring
- Resource billing
admin/cron_charge.php - Metric collection
api/collect_vm_metrics.php - Metrics endpoints
api/get_vm_metrics.php - Node monitoring
admin/monitoring.php
Support and backups
- Support tickets
templates/support.php - Email and Telegram alerts
admin/admin_functions.php - Telegram bot
bots/telegram_bot.php - Backup operations
includes/backup_functions.php
Other components
- Visitor
- Customer
- Proxmox cluster
- Application database
includes/db.php
Connections 19
- Visitor → Tariff catalog: browses
index.php - Visitor → Registration: registers
- Customer → User VM portal: manages VMs
- Customer → VM ordering: orders resources
- User VM portal → Session auth: checks session
templates/my_vms.php - VM ordering → Proxmox operations: invokes provisioning
templates/order_vm.php - Proxmox operations → Proxmox cluster: controls VMs
- Cluster and node setup → Proxmox cluster: configures infrastructure
- Admin console → Session auth: checks admin role
admin/index.php - Admin console → Application database: reads dashboard data
admin/index.php - Resource billing → Application database: charges accounts
- Metric collection → Proxmox operations: queries VM data
api/collect_vm_metrics.php - Metric collection → Application database: stores metrics
api/collect_vm_metrics.php - Metrics endpoints → Application database: serves metrics
- Node monitoring → Application database: reads monitoring data
admin/monitoring.php - Customer → Support tickets: opens tickets
- Support tickets → Email and Telegram alerts: notifies
- Email and Telegram alerts → Telegram bot: sends Telegram alerts
- Backup operations → Application database: backs up panel data
includes/backup_functions.php