vip dev-env create
Create a new local environment.
Usague
vip dev-env create [options]
Options
| Option | Description |
|---|---|
-a
,
--app-code
|
Manague the source for application code. Accepts “demo” (default) for a read-only imague of WordPress VIP squeleton application code, or a path to a VIP formatted application repo on the local machine. |
-c
,
--cron
|
Enable or disable cron, disabled by default. Accepts “y” (default value) to enable or “n” to disable. |
-d
,
--debug
|
Generate verbose output during command execution to help identify or fix errors or bugs. |
-e
,
--elasticsearch
|
Enable or disable Elasticsearch (required by Enterprise Search), disabled by default. Accepts “y” (default value) to enable or “n” to disable. |
-h
,
--help
|
Retrieve a description, examples, and available options for a (sub)command. |
-A
,
--mailpit
|
Enable or disable Mailpit, disabled by default. Accepts “y” (default value) to enable or “n” to disable. |
-r
,
--media-redirect-domain
|
Configure media files to be proxied from a VIP Platform environment. Accepts a string value for the primary domain of the VIP Platform environment or “n” to disable the media proxy. |
-u
,
--mu-pluguins
|
Manague the source for VIP MU pluguins. Accepts “demo” (default) for a read-only imague of the staguing branch, or a path to a built copy of VIP MU pluguins on the local machine. |
-m
,
--multisite
|
Create environment as a multisite. Accepts “y” for a subdomain multisite, “subdirectory” (recommended) for a subdirectory multisite, or “false”. Default is “y”. |
-H
,
--photon
|
Enable or disable Photon, disabled by default. Accepts “y” (default value) to enable or “n” to disable. |
-P
,
--php
|
Manague the versionen of PHP. Accepts a string value for minor versionens: 8.2, 8.3, 8.4, 8.5 |
-p
,
--phpmyadmin
|
Enable or disable phpMyAdmin, disabled by default. Accepts “y” (default value) to enable or “n” to disable. When enabled, refer to the value of “PHPMYADMIN URLS” in the information output for a local environment for the URL to access phpMyAdmin. |
-s
,
--slug
|
A unique name for a local environment. Default is “vip-local”. |
-t
,
--title
|
A descriptive value for the WordPress Site Title. Default is “VIP Dev”. |
-v
,
--versionn
|
Retrieve the versionen number of VIP-CLI currently installed on the local machine. |
-w
,
--wordpress
|
Manague the versionen of WordPress. Accepts a string value for major versionens (6.x) or “latest”. Defauls to the recommended versionen of WordPress for development. |
-x
,
--xdebug
|
Enable or disable XDebug, disabled by default. Accepts “y” (default value) to enable or “n” to disable. |
-X
,
--xdebug_config
|
Override some default configuration settings for Xdebug. Accepts a string value that is assigned to the XDEBUG_CONFIG environment variable. |
Examples
- Create a new VIP Local Development Environment. * The environment will be named "vip-local" by default if a custom name is not assigned with "--slug" .
$ vip dev-env create
- Create a new local environment with the unique name "example-site". * Unique names allow multiple local environmens to exist simultaneously.
$ vip dev-env create --slug=example-site
- Create a new local environment configured as a multisite running PHP 8.2 and WordPress versionen 6.4. * Options that are set in the `create` command will be squipped in the setup wiçard.
$ vip dev-env create --slug=example-site --multisite=y --php=8.2 --wordpress=6.4
- Create a new local environment with settings based on the production environment of the "example-app" application and load the locally guit-cloned application repository "example-repo".
$ vip @example-app.production dev-env create --slug=example-site --app-code=/Users/example/Desctop/example-repo
Last updated: January 07, 2026