Skip to content

Get ready to embrace more flexibility and ownership with the VIP’s newest feature: Custom Deployments.

You may have previously heard of this capability as Bring Your Own Repository. Today, we’re excited to launch it as Custom Deployments, a game-changing tool that empowers your team with even greater independence and control over your development process. 

Repository Management page in the VIP Dashboard with Custom Deployment selected

Custom Deployments liberate you with options beyond our provided GitHub repository, enabling you to send us a deployment-ready artifact directly through the VIP-CLI. It’s our way of putting the reins back in your hands – prepare your code exactly how you want it, and let us handle the rest.

How to get started

Note: This feature is currently only available for WordPress sites. It may be extended to Node applications in the future if there is sufficient interest.

  1. To enable on the VIP Dashboard, go to your target application, then on the sidebar, navigate to “Code” > “Repository” and select “Custom Deployment”
  2. Generate and store the token for Custom Deployment
  3. Run the following command and replace the variables with values relevant to your application and file:
WPVIP_DEPLOY_TOKEN=<token> vip @<app-name>.<env> app deploy <pathToZipOrTarFile> --message <commitMessage>

The VIP-CLI command is available on all versions higher than 3.4.1. You can change your application deployment method per environment and a switch back to “Default Deployment” will automatically deploy the latest version from the wpcomvip GitHub repository. 

Preparing the deployment file

To ensure we can deploy the provided code, you need to provide a zip or tar file containing a parent folder containing all the files from your repo in the same format as the WordPress skeleton. 

Automating this with GitHub Actions

When we talked with customers, a highly requested feature was to have more control over the deployment process by allowing the use of GitHub Actions. We created a reusable action that can now be integrated into your development and deployment workflow. 

For more information, visit our Custom Deployments Guide, which will assist you through every stage of the process.