Installation options
Mac users: We recommend using Homebrew as it’s the easiest installation method and doesn’t require installing Node.js separately. Windows users or those who prefer NPM: Use the NPM installation method, which works across all platforms but requires Node.js to be installed first. You can also download the CLI binary directly from GitHub releases if you prefer not to use a package manager.Install via Homebrew
The easiest way to install the Lightdash CLI on Mac is using Homebrew. This method doesn’t require you to install Node.js separately:Install via NPM
Before installing Lightdash CLI via NPM, you need to have NodeJS/NPM installed on your machine. To check that, run the following command in your terminal:Don't have NodeJS/NPM installed in your system?
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.Restart terminal and install NodeJS by runningCheck that NodeJS is installed by runningRunning the command above should output something like
Alternatively, you can install NodeJS/NPM via your preferred package manager.
20.8.0
which means you’ve succesfully installed NodeJS/NPM Alternatively, you can install NodeJS/NPM via your preferred package manager.
If you get an
npm ERR! code EACCES
error while installing the Lightdash CLI, follow this guide to resolve it.Download binary directly
You can also download the CLI binary directly from GitHub releases.Updating the Lightdash CLI
Update to the latest version
To update your Lightdash CLI to the latest version, run:Update to a specific version
To update (or downgrade) to a specific version of the Lightdash CLI, run:VERSION_NUMBER
with the desired version. For example:
You can check your current CLI version by running
lightdash --version
.