The installation process is rather simple, but it can differ a bit depending on your Operating System.


Adgile is available as a Node Package, and thus requires NodeJS to install and run it from the command line. Head over to the NodeJS website and grab the installer for your OS. The recommended version is, well... recommended as this one contains the most stable release.

You can check if the installation was successful by typing the commands node -v and npm -v in your command line. If the respective versions of NodeJS and NPM are printed out, then you're good to go to the next step!

Note: Make sure you restart your command line if it was open during installation. Otherwise the above commands may not be immediately available.


Support for Sass is built-in in Adgile, but it has to be installed separately. This is easy now that we have NodeJS installed.
Simply use the following command:

npm install -g sass

After the installation is finished, you can check the Sass version with sass -v.

If you want to learn more about how Sass works, you can find all the documentation on the official website.


Now that we have the requirements out of the way, it is time for the most critical step: the installation of Adgile itself. This is as simple as installing any node package:

npm install -g adgile

Again, you can make sure that the installation was successful by checking the package version with adgile -v or adg -v.

Note: during the installation process, you may notice a lot of "Deprecated" notices. This is normal and does not imply an error. It simply means that some of the packages that Adgile is based on need to be updated. This is up to the package owners to fix.

Possible errors during installation

  • Permission denied or Error: EACCESS

    Any time you encounter this error, type the same command again, but add sudo at the beginning. After pressing enter, you will be asked to type in your password. In this way, you tell the command line that you have administrator rights.

  • Sudo doesn't work

    This fix has only been tested with Adgile's installation so far. But it will probably work with other packages as well. Type the following command:

    sudo npm install -g adgile --unsafe-perm=true --allow-root

    This makes sure you are installing Adgile as the root user.


Updating Adgile to the latest version is as simple as using this command:

npm update -g adgile

If any permission errors pop up, start with sudo.