Title: vip dev-env destroy
Published: August 3, 2026

---

 1. [VIP-CLI command reference](https://docs.wpvip.com/vip-cli/commands/)
 2. [vip dev-env](https://docs.wpvip.com/vip-cli/commands/dev-env/)
 3. vip dev-env destroy

#  vip dev-env destroy

Remove a local environment.

## Usage

    ```wp-block-preformatted
    vip dev-env destroy [options]
    ```

## Options

| Option | Description | 
|  `-h`, `--help` |  Retrieve a description, examples, and available options for a (sub)command. (default: false) |  
|  `-v`, `--version` |  Retrieve the version number of VIP-CLI currently installed on the local machine. (default: false) |  
|  `-d`, `--debug` |  [value] Generate verbose output during command execution to help identify or fix errors or bugs. |  
|  `-s`, `--slug` |  [value] A unique name for a local environment. Default is “vip-local”. –soft [value] Preserve an environment’s configuration files; allows an environment to be regenerated with the start command. |

## Examples

    ```wp-block-preformatted
    - Completely remove a local environment named "example-site" by removing all Docker containers, volumes, and configuration files.$ vip dev-env destroy --slug=example-site- Remove the Docker containers and volumes of a local environment named "example-site" but preserve the configuration files.
    * The preserved configuration files allow the local environment to be restarted with new Docker containers and volumes.$ vip dev-env destroy --soft --slug=example-site
    ```

Last updated: August 03, 2026