VIP Go platform specific
This document is for sites running on VIP Go.
Contents
Overview #
VIP CLI is the command line interface for VIP Go. You can use VIP CLI to interact with your VIP applications, query information about your applications, and perform actions like syncing data from production to development environments.
VIP CLI is aimed at developers, and familiarity with installing CLI applications and using the Terminal is required. We are developing a web based VIP Dashboard, which will provide access to similar functionality in a graphical user interface.
What commands does the CLI offer? #
You can view the available commands with the vip --help
command:
$ vip --help Usage: vip [options] [command] Commands: app List and modify your VIP Go apps help Display help logout Logout from your current session sync Sync production to a development environment Options: -h, --help Output usage information -v, --version Output the version number
Installing VIP CLI locally #
VIP CLI is a Node.js Package and can be installed through a package manager like npm.
VIP CLI requires Node.js v8.9.0+
and npm v5.7.1+
. If either or both are below the required versions, see the upgrade steps in our troubleshooting section below.
To begin installation, visit our VIP CLI page installation page and follow the instructions.
Note: It is extremely important not to install VIP CLI using the sudo
command; if this has been done you can follow the directions below.
Troubleshooting #
Status code 401
#
You may receive an error including the line Received status code 401
, for example:
Failed to fetch apps: Error: Network error: Response not successful: Received status code 401
Please try the following:
- Run
vip logout
- Run
vip
and follow the prompts to log in again
I can’t see all my applications #
For you to access an application via VIP CLI, you must have access to the GitHubrepository for that application. If you do not see all the applications you expect when running vip app list
, please follow this procedure:
- Check you have access to the GitHub repository for the application(s) you expect to see, if you do not have access to these repositories on GitHub then you should contact someone in your team who has admin rights or alternatively contact VIP support
- If you do have access to the application repository on GitHub, but you do not see the application listed via
vip app list
then… - Run
vip logout
- Run
vip
and follow the prompts to log in - Run
vip app list
, If you are still not seeing all the applications you expect then please get in touch with VIP support
Installing Node #
Please follow the Node.js project’s installation instructions.
Installing npm #
Installing Node.js (instructions above) will include npm in the installation.
Upgrading Node.js #
Follow the Node.js installation instructions to acquire and install the latest version of Node.js, or use the upgrade command if you installed via a package manager like Homebrew for macOS.
Upgrading npm #
If you have npm installed already, you can run the following command to update to the latest version:
npm install -g npm
Fixing NPM/Node permissions #
Read this npm guide: How to Prevent Permissions Errors.
If you have installed various commands with sudo
you will need to reverse the process, fix the permissions errors, then install the command without the use of sudo
.
Help, I used sudo
to install VIP CLI! #
You should not use sudo
to fix access permissions; instead, please see “Fixing permissions” above.
WARN install EACCES: permission denied
#
See “Fixing permissions” above.