Skip to content

Troubleshooting: Backups

A backup failed

  • The task records BACKUP_FAILED and the provider reason. Check the backup destination connectivity and free space: pterocloud:backup:health, pterocloud:backup:inspect.
  • A destination that is unreachable reports BACKUP_DESTINATION_UNREACHABLE; a full destination reports BACKUP_DESTINATION_FULL. Neither is auto-resolved.
  • Quota exhaustion reports BACKUP_QUOTA_EXCEEDED; raise the policy quota or adjust retention.

Verification failed

BACKUP_VERIFY_FAILED means a stored backup did not pass verification. Do not delete it automatically; inspect it with pterocloud:backup:inspect and retain it until an operator decides.

Restore failed

RESTORE_FAILED leaves the restore operation in a recoverable state. Inspect the restore operation and the instance; a failed restore never deletes the source backup.

A backup record is stuck

php artisan pterocloud:backup:audit
php artisan pterocloud:backup:reconcile
php artisan pterocloud:backup:health

reconcile is report-only.