CLI Installation Guide

To build scenes for Decentraland you will need to install the Command Line Interface (CLI).

The CLI allows you to compile and preview your scene in an “off-chain” development environment. After testing your scene locally, you can use the CLI to upload your content to the content server, linking it with your LAND.

Please note: Currently, the Decentraland SDK (bundled with the CLI installation) only supports TypeScript.

The Decentraland CLI is distributed via npm.

Before you Begin

Please install the following dependencies before you install the CLI:

Install the CLI

Open the Terminal app and run the following command:

npm install -g decentraland

Once the installation is complete, the dcl command will be globally available.

Update the CLI on any platform

To update the CLI to the latest supported version, we recommend first uninstalling the CLI and then reinstalling a fresh version. To do this, run the following commands:

// uninstall
npm rm decentraland -g

// install
npm install -g decentraland

Update the SDK version of a scene

If your CLI is up to date, the new projects you create with it will use the latest version of the SDK.

The SDK version used by your existing projects doesn’t change by updating the CLI. You need to manually update the SDK version in the projects.

Run the following command on the scene folder:

npm i decentraland-ecs@latest

You can confirm that it worked by checking the package.json file for the scene, and looking for the decentraland-ecs version there.


If you get error messages when attempting to install the CLI, check this thread.