WordPress VIP Go Local Development
- Mac OS X >= 11.6
- Standard binaries (
sudo,sed,curl,tar,grep,perl) docker(withcompose)git(recommended:brew install gitand update$PATH)openssl(recommended:brew install openssl@1.1and update$PATH)
git clone https://github.com/automattic/vip-gold && cd vip-goldcp .env.sample .env- Modify values in
.env:VIPGO_DOMAIN= the domain name the local development environment should useVIPGO_UPSTREAM_MEDIA_HOST= for assets referenced in/wp-content/uploads/*that don't exist locally, a domain name that can be used to send requests for the assets toVIPGO_REPOSITORY= WPVIP structured project togit cloneintoapp/wp-content/, defaults to WPVIP "skeleton"VIPGO_PHP_VERSION= PHP version to use, defaults tolatest
make initmake dev/up
Executing make dev/up will automatically:
- Use
opensslto generate a root Certificate Authority (CA), if one doesn't exist, and add it to your$HOME/Library/Keychains/login.keychain-dbkeychain - Use
opensslto generate a TLS certificate+key for the given$VIPGO_DOMAINutilizing the root CA - Update
hosts(5)with127.0.0.1 $VIPGO_DOMAIN
If the Mozilla Firefox browser is used, extra steps are needed:
- Navigate to
about:config - Search for
security.enterprise_roots.enabled - Double click the result if set to
falsein order to set it totrue - Restart Mozilla Firefox
init - sets up environment requirements/dependencies
dev/up - alias of docker compose up -d
dev/down - alias of docker compose down
dev/upgrade - update all container images and provided mu-plugins
dev/restart - stop and start the environment
dev/reset - WARNING! removes app/ and data/
dev/xdebug/on - enable xdebug support
dev/xdebug/off - disable xdebug support
hosts/add - add VIPGO_DOMAIN to /etc/hosts
hosts/remove - remove VIPGO_DOMAIN from /etc/hosts
tls/ca - generate certificate authority, add to keychain
tls/domain - generate VIPGO_DOMAIN cert + key
tls/reset - remove certificate authority and VIPGO_DOMAIN cert+key
SQL=file.sql db/import - imports file.sql into mariadb instance
db/export - exports mariadb DB into VIPGO_WP_DB_NAME.sql