How to Install Catalyst CLI ?

Estimated reading: 3 minutes 327 views

The Catalyst CLI lets you build, test and deploy your Zoho Catalyst apps from your local machine, whether you are working with serverless functions, SmartBrowz automation or Cloud Scale services. It works in your project’s development environment, so changes made with the CLI do not affect your live app until you explicitly deploy them. The CLI is supported on Windows, macOS and Linux, with the same installation process on each.

Check the prerequisites

Node.js and NPM

The Catalyst CLI is installed using NPM or Yarn, so you need Node.js (version 14 or later) and NPM installed first. Check whether they are already installed by running node -v and npm -v. If not, download Node.js from its official website, or use a version manager such as NVM. NPM is bundled with Node.js, so installing Node covers both.

Programming language environments (optional)

If you plan to write functions in these languages, install the environment you need:

  • Java: install JDK version 8, 11 or 17.
  • Python: install Python 3.10, with Pip available (Pip is included with the official installer).

Only install the environments for the languages you plan to use.

Install the Catalyst CLI

Open your terminal with admin privileges: on Windows, right-click and choose Run as Administrator; on macOS or Linux, add sudo before the command.

Install via NPM:

npm install -g zcatalyst-cli

Or using Yarn:

yarn add zcatalyst-cli

Once installation completes, verify it worked by running catalyst --version. You should see the installed version number, which means the CLI is ready to use.

Update the Catalyst CLI

The CLI lets you know when a new version is available.

To update, run npm install -g zcatalyst-cli again. If you run into trouble, specify the version explicitly, for example npm install -g zcatalyst-cli@1.9.0, or add sudo on macOS or Linux: sudo npm install -g zcatalyst-cli.

Tips

  • Use Node.js version 14 or higher.
  • Use the CLI in the development environment unless you are ready to go live.
  • Keep the CLI updated for the latest features and fixes.
  • Check the CLI command reference for the full list of commands and options.

Frequently asked questions

Which operating systems does the Catalyst CLI support?

Windows, macOS and Linux, with the same installation process on each.

Does the CLI affect my live app straight away?

No, the CLI works in your project’s development environment, so changes only reach your live production app once you explicitly deploy them there.

How do I update the Catalyst CLI?

Run the same install command, npm install -g zcatalyst-cli, again, or specify a version explicitly if you run into problems.

Need help?

Need help setting up the Catalyst CLI for your team? Contact support@thoughtlogik.com or see our Zoho custom app development services.

Leave a Reply

Your email address will not be published. Required fields are marked *

Learn how we helped 100 top brands gain success

Subscribe

×
Cancel