Skip to main content

installation

Installation

Holesail is currently available as a npm package or can be run from the source. Installing and using holesail is pretty simple.

We will soon distribute holesail as a binary but at the moment using it from npm or building from the source is the only solution.

Requirements

  • Operating system:
    • Windows
    • Linux
    • Mac
  • Node version (v16.20.2 or above)

Make sure you have node version >= v16.20.2, you can install and switch between node versions using Node version manager on Linux and Mac.

Install through npm

You need to install holesail as a global package to use it from anywhere in the terminal/cmd.

On Windows / Mac

npm i holesail -g

Linux

Installing global packages on Linux requires sudo privileges:

sudo npm i holesail -g

You can then verify if the installation was successful using:

holesail --help

Running from source

You can run holesail from its source on GitHub. The process is straightforward and similar to other Node.js packages.

git clone https://github.com/holesail/holesail.git && cd holesail

Install the dependencies:

npm install

Finally, run the package:

node index.js

You can pass arguments directly to index.js, such as --help