Skip to content

vip dev-env create

Create a new local dev environment

Usage

vip dev-env-create [options]

Options

OptionDescription
-a, --app-code Use the application code from a local directory or use “demo” for VIP skeleton code
-d, --debug Activate debug output
-e, --elasticsearch Enable Elasticsearch (needed by Enterprise Search)
-h, --help Output the help for the (sub)command
-G, --mailhog Enable Mailpit. By default it is disabled (deprecated option, please use –mailpit instead)
-A, --mailpit Enable Mailpit. By default it is disabled
-r, --media-redirect-domain Domain to redirect for missing media files. This can be used to still have images without the need to import them locally.
-u, --mu-plugins Use a specific mu-plugins changeset or local directory
-m, --multisite Enable multisite install
-H, --photon Enable Photon. By default it is disabled
-P, --php Explicitly choose PHP version to use
-p, --phpmyadmin Enable PHPMyAdmin component. By default it is disabled
-s, --slug Custom name of the dev environment
-t, --title Title for the WordPress site
-v, --version Output the version number
-w, --wordpress Use a specific WordPress version
-x, --xdebug Enable XDebug. By default it is disabled
-X, --xdebug_config Extra configuration to pass to xdebug via XDEBUG_CONFIG environment variable

Examples

- Creates a local dev environment
$ vip dev-env create

- Creates a local dev environment for production site for id 123
$ vip @123.production dev-env create

- Creates a local dev environment aliased as "my_site"
$ vip dev-env create --slug=my_site

- Assigning unique slugs to environments allows multiple environments to be created.
$ vip dev-env create --slug=test

- Creates a local multisite dev environment using WP 5.8 and application code is expected to be in "~/git/my_code"
$ vip dev-env create --multisite --wordpress="5.8" --app-code="~/git/my_code"

- Creates a local multisite dev environment with a subdirectory URL structure using WP 5.8 and application code is expected to be in "~/git/my_code"
$ vip dev-env create --multisite=subdirectory --wordpress="5.8" --app-code="~/git/my_code"

Last updated: February 08, 2024