Skip to content


How-to Guides

Technical References


Troubleshooting VIP-CLI

Resource restrictions

In order to maintain the integrity of site performance on VIP and the various services they require, commands that utilize excessive CPU, memory,  or input/output (I/O) may be terminated. Review VIP’s recommendations for writing custom WP-CLI commands to optimize the performance of custom commands.

Applications missing from vip app list

To access an application via VIP-CLI, a user must have at least an App read role for that application. Check that the user has at least an App read role for the application(s) that they expect to see.

If a user does have an App read role or greater for the application they expect to see, but that application is not listed via vip app list, the user should try logging out and back in again to retry the command.

  1. Run vip logout.
  2. Run vip and follow the prompts to log in.
  3. Run vip app list. If all of the expected applications are still not listed, contact VIP Support.

To run WP-CLI commands that make modifications to an application’s database, a user must have at least an App write role for that application.

“Command cancelled”

This error is received when the command is cancelled either manually by the user or automatically by VIP’s systems for exceeding resource limits.

“Connection lost, retrying…”

If a user’s internet connection drops while a command is running, VIP-CLI will attempt to reconnect in the background. During this process, the “Connection lost, retrying…” message will be logged to the console. If the connection cannot be re-established in the span of 1 minute, attempts to reconnect will discontinue and the terminal will be disconnected from the command.

“Error during Handshake”

This error can occur if stdin input is being manipulated through a shell utility such as xargs. For more information, refer to the Looping section of Advanced usage for VIP-CLI.

“Error: Rate limit exceeded: Please wait a moment and try again.”

VIP uses rate-limiting to reduce API-abuse and charges to VIP’s APIs. This error indicates that too many requests are being sent to VIP’s servers either from the VIP Dashboard, VIP-CLI, or both.

To resolve this error:

  • Close any non-used VIP Dashboard or VIP-CLI windows
  • Reduce the number of concurrent commands running with VIP-CLI
  • If a VIP-CLI command has not stopped correctly (especially if the command was killed using  Control + C, or equivalent) some remaining processes may still be running in the background. To stop these processes, quit the command line window completely.

Rate limit errors are between the end-user and VIP’s APIs. Though these errors appear in the VIP-CLI terminal window, they are not affecting the original output or logs of the command. Even if these errors occur, the VIP-CLI command is still running successfully.

“Maximum running command count has been reached for the site”

A maximum of four WP-CLI commands can run concurrently on a VIP production environment, and a maximum of two WP-CLI commands can run concurrently on non-production environments. Refer to the WP-CLI panel of the VIP Dashboard to review or cancel commands that are currently running on an environment.

“Received status code 401”

This error can be returned as part of a longer message in. the terminal, for example:

Failed to fetch apps: Error: Network error: Response not successful: Received status code 401

To resolve this error:

  1. Run vip logout.
  2. Run vip and follow the prompts to log in again.

“The command is not permitted at this time”

A specific subset of core and other WP-CLI commands are disallowed for reasons of security, performance, and more. To view a full list of the commands that are available for use, run wp help.

“Error: <command> is not a valid subcommand.”

If you receive an error that a subcommand is not valid, we recommend that the first thing you do (after checking your command for spelling errors!) is to update VIP-CLI to the latest version. The latest VIP features and subcommands are introduced in the most current versions of VIP-CLI.

Last updated: January 13, 2022