Uninstall

Uninstalling PteroCloud removes the extension from the panel. It never deletes or powers off customer VMs, disks, backups or IPs; those live on the hypervisors and are owned by libvirt/QEMU or the provider.

Before you uninstall

1. Take a database backup.
2. Save a support bundle and the diagnostic reports (see Diagnostics & support).
3. Note any provider connections and enrollment tokens you will need to revoke out of band.

Steps

1. Stop the workers and the console gateway:

sudo systemctl stop pterocloud-queue pterocloud-scheduler
# stop the console-gateway process/service

1. Remove the extension directory panel/extensions/pterocloud.
2. Clear caches:

php artisan config:clear && php artisan cache:clear && php artisan view:clear

1. Optionally drop the PteroCloud tables. This destroys panel-side records only (instances, tasks, history). It does not touch provider workloads.

!!! danger "Back up first" Dropping tables is irreversible. Restore from backup if unsure.

1. Remove the nginx site and systemd units if you are fully decommissioning the host.

Deactivating the license

To release the license slot before removal:

php artisan pterocloud:license:deactivate

This deactivates the installation and releases its slot. See License recovery.

After uninstall

• Existing VMs keep running on their hypervisors.
• Revoke any provider API tokens you created for the panel (pveum user token remove pterocloud@pve panel).
• Revoke any agent credentials on native hosts.

Related

• Repair
• Licensing recovery