Troubleshooting¶

Start with the code shown in the panel, look it up in the error reference, then follow the matching page.

Subsystem	Page
Installation	Installation
Licensing	Licensing
Proxmox	Proxmox
Native KVM	Native KVM
Networking	Networking
Storage	Storage
Console	Console
Backups	Backups
Scheduler	Scheduler
Migration	Migration
High availability	High availability
Security	Security
Updates	Updates

First moves¶

php artisan pterocloud:health
php artisan pterocloud:diagnose --scope=control_plane
php artisan pterocloud:error <PC-XXX-###>

An error page¶

The Diagnostics Center lists the error catalog and recent error events. Every customer-facing error carries a support id that maps to a redacted event.

Diagnostics errors

Support bundles¶

Generate a redacted support bundle before escalating; it never contains secrets and is never uploaded automatically. See Diagnostics & support.

No secret sharing

Never paste a license key, provider token, password or enrollment token into a ticket. Redact screenshots. All placeholders in this documentation (KRP-XXXXX-…, YOUR_PROVIDER_TOKEN, panel.example.com, 203.0.113.10) are examples.