Skip to main content

How to install the Lightdash CLI

The Lightdash CLI is the recommended way to develop your dbt + Lightdash project. It makes development faster and easier, as well as giving you options for building more powerful automation to manage your Lightdash instance.

Before installing Lightdash CLI, you need to have NodeJS/NPM installed on your machine. To check that, run the following command in your terminal:

node -v; npm -v;
# it should print something like:
# v20.8.0
# 8.15.0
Don't have NodeJS/NPM installed in your system?

We recommend installing NodeJS/NPM using NVM (Node Version Manager) which works for POSIX-compliant shells (sh, dash, ksh, zsh, bash on these platforms: unix, macOS, and windows WSL)

Open your terminal and run the command below to install NVM (Node Version Manager) to your system.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.2/install.sh | bash
# or
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.2/install.sh | bash

Restart terminal and install NodeJS by running

nvm install --lts

Check that NodeJS is installed by running

node -v

Running the command above should output something like 20.8.0 which means you've succesfully installed NodeJS/NPM 🎉


Alternatively, you can install NodeJS/NPM via your preferred package manager.

Run the following on your terminal to install the Lightdash CLI.

npm install -g @lightdash/cli
info

If you get an npm ERR! code EACCES error while installing the Lightdash CLI, follow this guide to resolve it.

Once you've installed the CLI tool, you'll want to authenticate it​

Check out the guide on authenticating your CLI tool (login and setup an active project).