Managing Restores¶
Learn how to restore backups through the Velero Dashboard.
Viewing Restores¶
- Select a cluster from the dropdown
- Navigate to Restores in the sidebar
- View the list of all restore operations
Restore List¶
The restore list shows:
- Name: Restore operation name
- Backup: Source backup name
- Status: Completed, InProgress, Failed, etc.
- Warnings/Errors: Number of issues
- Created: When restore was initiated
Creating a Restore¶
- Navigate to Backups
- Click on the backup you want to restore
- Click Create Restore button
- Configure restore options:
- Name: Unique restore name (optional, auto-generated if empty)
- Namespace Mappings: Map source to target namespaces
- Exclude Resources: Resources to skip during restore
- Restore PVs: Whether to restore persistent volumes
- Preserve Node Ports: Keep original node port values
-
Include Cluster Resources: Restore cluster-scoped resources
-
Click Create to start the restore
Restore Options¶
Namespace Mapping¶
Restore to a different namespace:
Example: production:staging
Excluding Resources¶
Skip specific resource types:
Partial Restore¶
Use label selectors to restore only specific resources from a backup.
Viewing Restore Details¶
Click on a restore name to view:
- Metadata: Creation time, source backup
- Status: Current phase and completion
- Resources: What was restored
- Warnings: Non-critical issues
- Errors: Critical failures
- Logs: Restore operation logs
Viewing Restore Logs¶
- Click on a restore
- Click View Logs tab
- Review the complete restore log
Useful for debugging failed restores or understanding what was restored.
Restore Status¶
| Status | Description |
|---|---|
| New | Restore created, not started |
| InProgress | Restore currently running |
| Completed | Restore finished successfully |
| PartiallyFailed | Some resources failed to restore |
| Failed | Restore encountered critical errors |
Common Restore Scenarios¶
Disaster Recovery¶
Restore entire namespaces after cluster failure:
- Create new cluster
- Install Velero with same BSL configuration
- Restore from backup
Namespace Migration¶
Move workloads between namespaces:
- Create backup of source namespace
- Use namespace mapping to restore to target namespace
Selective Restore¶
Restore specific resources:
- Use label selectors to filter resources
- Exclude unwanted resource types
Cross-Cluster Migration¶
Move workloads to different cluster:
- Backup from source cluster
- Configure same BSL on target cluster
- Restore to target cluster
Best Practices¶
- Test Regularly: Perform restore drills to ensure backups are valid
- Dry Run: Test restore configuration before production restores
- Namespace Isolation: Use namespace mappings to avoid conflicts
- Review Logs: Always check restore logs for warnings
- Incremental: Start with small restores before full disaster recovery
Troubleshooting¶
Restore Stuck in InProgress¶
- Check Velero pod logs
- Verify target cluster has sufficient resources
- Check if any resources are blocking completion
Resources Not Restored¶
- Check if namespace exists
- Verify permissions
- Review exclude/include filters
- Check backup content
PV Restore Issues¶
- Verify volume snapshot locations are configured
- Check storage class compatibility
- Ensure PVs exist in backup