This guide covers how to clean up cached data, remove licenses, maintain your Docker environment, and completely uninstall WP Staging CLI.
Cleanup Commands
WP Staging CLI provides several cleanup commands to manage cached data and stored credentials.
Clean Cache Files
Remove cached API responses and temporary data:
Cache files include:
Cache is automatically cleaned during normal operation (entries older than 4 hours are removed on startup).
Remove Stored License
Remove the locally stored license key without deactivating it on the server:
Use this when you want to:
Note: This only removes the local license file. The license remains active on your WP Staging account. Use wpstaging deactivate to fully deactivate the license.
Clean Everything
Remove all cached data and stored credentials:
This removes:
Deactivate License
To fully deactivate your license on the WP Staging servers and remove local storage:
This command:
Alias: You can also use wpstaging unregister.
Remove Docker Environment
If you’ve used the Docker features, remove all containers, volumes, and configurations:
Warning: This permanently removes all WordPress sites, databases, and Docker configurations. This action cannot be undone. You’ll be prompted for confirmation.
This command:
Important: Run this before uninstalling WP Staging CLI if you’ve used the Docker features.
Uninstall WP Staging CLI
To completely remove WP Staging CLI from your system:
Step 1: Remove Docker Data (if used)
If you’ve used Docker features, first clean up:
Step 2: Run Uninstaller
Linux, macOS, WSL:
Windows PowerShell:
Windows CMD:
The uninstaller removes:
Manual Uninstallation
If you prefer to uninstall manually:
Linux, macOS:
Windows PowerShell:
When to Use Each Option
| Scenario | Command |
|---|---|
| Clear temporary files and cache | wpstaging clean cache |
| Switch to a different license | wpstaging clean license then wpstaging register |
| Stop using this license on this machine | wpstaging deactivate |
| Remove all Docker sites and data | wpstaging remove |
| Complete uninstallation | wpstaging remove (if Docker used), then uninstall script |
| Reset everything but keep CLI installed | wpstaging clean all + wpstaging remove |
Cleanup Command Summary
| Command | What It Removes |
|---|---|
clean cache |
Cache files only |
clean license |
Local license file only (keeps active on server) |
clean all |
Cache + local license + other temporary data |
deactivate |
Deactivates on server + removes local license |
remove |
All Docker containers, volumes, sites, configs |
