Skip to content

Basic usage

Available VIP-CLI commands and their options can be reviewed by running vip --help (or -h):

$ vip -h
  Usage: vip [options] [command]

    app             List and modify your VIP applications
    config          Set configuration for your VIP applications
    dev-env         Use local dev-environment
    import          Import media or SQL files into your VIP applications
    logout          Logout from your current session
    logs            Get logs from your VIP applications
    search-replace  Perform search and replace tasks on files
    sync            Sync production to a development environment
    whoami          Display details about the currently logged-in user
    wp              Run WP CLI commands against an environment

    -d, --debug    Activate debug output
    -h, --help     Output the help for the (sub)command
    -v, --version  Output the version number

A help menu for individual commands can be viewed by running: vip [command] -h

For example, to view the options and more information about the vip config command:

$ vip config -h
  Usage: vip config [options] [command]

    envvar  Manage environment variables for an application environment

    -d, --debug    Activate debug output
    -h, --help     Output the help for the (sub)command
    -v, --version  Output the version number

VIP-CLI commands

To run a VIP-CLI command against an application’s environment, a user must have an App write role or greater for that application.

A VIP-CLI command can only be run against one environment at a time, so both an application and one of its environments must be specified in a VIP-CLI command.

An environment can be targeted in a VIP-CLI command by including the application’s alias, a dot separator, and the target environment type: @<app-alias>.<env>

For example, to target the preprod environment for an application with the alias mytestsite:

$ vip @mytestsite.preprod sync
+ App: mytestsite (id: 4323)
+ Environment: preprod (id: 4354)
+ Replacements: 
│ from                    │ to                              │
│ // │ // │
? Are you sure you want to sync from production? (y/N) › false

WP-CLI commands

Running WP-CLI commands with VIP-CLI requires a double dash (--) separating the arguments of the vip command from those of the wp command. The double dash must be included to avoid unexpected issues due to parameter conflicts.

For example, to retrieve the list of WordPress users from the preprod environment of the mytestsite application:

$ vip @mytestsite.preprod -- wp user list

Interactive shell

VIP-CLI includes an interactive shell mode that provides a terminal-like interface into a VIP WordPress site.

To enter the interactive shell mode, run the VIP-CLI command: vip @<app-alias>.<env> -- wp

WP-CLI commands can then be run without the vip @<app-alias>.<env> -- argument structure.

$ vip @mytestsite.preprod -- wp 
mytestsite.preprod:~$ wp option get home  
mytestsite.preprod:~$ wp cache delete my-cache-key my-cache-group 
Success: Object deleted.

Using the interactive shell mode is a convenient way to run multiple commands on the same environment and behaves much like a standard terminal or SSH session would. While the interactive shell looks and acts like a standard terminal, it does not currently support bash operators or commands (e.g. xargs, variable substitution, etc). Those commands need to be run in the standard VIP-CLI format.

Canceling a command

WP-CLI commands that are still running can be canceled by the user that initiated the command.

  • From the VIP-CLI terminal: Type the keyboard abort command Control + C.
  • From the VIP Dashboard: Navigate to the WP-CLI Commands panel. Select the “Cancel” option to the right of the Running command.

Last updated: August 29, 2022