Start with the panel itself: System › Health shows whether the workers and scheduler run, System › Tasks shows what each node did and why a task failed, and the audit log shows who changed what. When the panel does not answer, or a page tells you to look on the server, use the logs and commands below.
The first four pages are general tools. The pages after them go through common problems by area.
- Logs: the panel's log pages, log files and systemd units on the panel server and on nodes.
- Agent commands: every
vmstack-agentcommand, including the ones that get a node back after a network or firewall change. - Recovery commands: unlock sign-in, create an administrator, restart workers, and other artisan and
vmstack-panelcommands. - Workers and queues: which workers the panel runs and how to check them.
- Panel and licensing: messages from the panel installer, panel updates and licensing.
- Nodes and storage: node installs, enrolment, unreachable nodes, certificates, agent updates, the node firewall and storages.
- Networking: DHCP, IPv6, bridges, NAT, private networks, DNS and the server firewall.
- Servers: snapshots, rescue, password resets, the console, upgrades, moves, high availability and tasks.
- Images and templates: images and ISOs that do not reach a node, container images and Windows template builds.
- Backups and imports: destination checks, failed backups and restores, and imports from Proxmox VE, SolusVM, Virtualizor or KVM hosts.
- Billing and accounts: billing module errors, single sign-on links, customers who cannot create servers, bans, allowlists and lost second factors.
- LogsWhere VMStack writes its logs on the panel server and on nodes, the systemd units and journalctl commands to read them, and the panel's log pages.
- Agent commandsEvery vmstack-agent command you can run on a node: version, storage list, setup, add, grow and remove, bridge rollback and node-firewall off.
- Recovery commandsThe artisan and vmstack-panel commands to get back into a VMStack panel: unlock sign-in, create an administrator, restart workers, and more.
- Workers and queuesThe VMStack panel's queue workers and scheduler, what each queue does, how many workers run, and how to check and fix them when work stops.
- Panel and licensing problemsMessages from the VMStack panel installer, panel updates and licensing, what each one means, and how to fix it.
- Nodes and storageFixes for node installs, enrolment, unreachable nodes, certificates, agent updates, the node firewall, and file, thin, ZFS, NFS and Ceph storages.
- Networking problemsCommon networking errors on VMStack nodes and servers, from DHCP, IPv6 and bridges to NAT, private networks, DNS and the server firewall, with fixes.
- Servers troubleshootingCommon errors with snapshots, rescue, password resets, the console, upgrades, moves, live migration, high availability, start on boot and tasks, with the fix.
- Images, ISOs and templatesWhat to do when an image or ISO does not reach a node, a server cannot be made from an image, a container image fails, or a Windows template build stops.
- Backups and importsFixes for failed destination checks, backups that do not run or fail, refused restores, and imports from Proxmox VE, SolusVM, Virtualizor or KVM hosts that stop.
- Billing and accountsFix billing module errors, single sign-on links that fail, customers who cannot create servers, bans, allowlists and lost second factors.