You can refer to the Installing Catalyst CLI help page for help with installing the Catalyst CLI.

Once you have installed Catalyst CLI using the npm command, you can work with the CLI from your terminal. Catalyst commands begin with the keyword catalyst. You can refer to the CLI documentation for detailed help with all the CLI commands.

When a newer version of the Catalyst CLI is available, your terminal will display a message alerting you of it after you execute a CLI command successfully.

To update your CLI, execute the following command:

$ npm install -g zcatalyst-cli

Note:

• In rare cases, your system’s registry values might not reflect the latest version of Catalyst CLI. This might cause your system to retain the older version of the CLI. To avoid this, mention the version number while executing the command. For example, to update to the version 1.13.3, run $ npm install -g zcatalyst-cli @1.13.3

• If you are unable to update Catalyst CLI, execute the command using sudo.

Alternatively, you can visit the npm websiteto check whether you are using the latest version.

If there are any issues or abnormal behaviors detected in the CLI, Catalyst will automatically create a catalyst-debug.log file in the directory the command executed. You can then contact the Catalyst team through our support email address: support@zohocatalyst.com.

Please provide a brief description of the issue and attach the catalyst-debug.log file in the email. The Catalyst team will contact you in less than 24 hours with a solution for the issue.

Catalyst CLI only supports Node engines higher than 8.15. If you encounter this error, it could mean that you have a lower version of Node.js installed in your system.

You can update the Node.js version to resolve this error by downloading the Node.js installer from the Node.js website. You must then open the installer to install it on your system. To check if Node.js has been updated successfully, execute the following command in your terminal:

$ node -v

You will encounter this error if strict TLS authorization has been enabled in your system. You can resolve this error by executing the following command in your terminal:

$ set NODE_TLS_REJECT_UNAUTHORIZED=0

You can now retry executing the Catalyst command. If the issue still isn’t resolved, contact Catalyst support at support@zohocatalyst.com for further assistance.

The CLI only compiles the Java classes at runtime. Therefore, if the version of the Java environment and the javac you are using are different, you will encounter this error.

You can check the Java version by executing the following command in your terminal:

$ java -version

Similarly, you can check the javac version by executing the command in your terminal:

$ javac -version

If they are different, write the value of the Java path as “8” in the “PATH environment” variable and execute the command again. This will resolve the issue.

If you have any further queries, you can contact Catalyst support at support@zohocatalyst.com.