# Enmap Installation

### Pre-Requisites

In order to install Enmap, you'll need a few things installed on your machine. First off, you need NodeJS (version 8 or higher required). For Windows and MacOS, simply[ download and install from the website](https://nodejs.org/en/download/). For Linux, see [this page for installation](https://nodejs.org/en/download/package-manager/).

Enmap v3 is no longer maintained on NPM and is only available on Github. You will need to install a git tool on your computer to install it.&#x20;

Next, enmap has a specific pre-requisite which is needed for the sqlite dependency. How to install these depends on your operating system, so see below for instructions:

{% tabs %}
{% tab title="Windows" %}
On Windows, two things are required to install enmap-sqlite. Python 2.7 and the Visual Studio C++ Build Tools. They are required for any module that is *built* on the system, which includes sqlite.&#x20;

> The Windows Built Tools require over 3GB of space to install and use. Make sure you have enough space before starting this download and install!

To install the necessary pre-requisites on Windows, the easiest is to simply run the following command, *under an **administrative** command prompt or powershell:*

```javascript
npm -g --add-python-to-path install windows-build-tools node-gyp
```

> It's *very important* that this be run in the **administrative** prompt, and not a regular one.

Once the windows-build-tools are installed (this might take quite some time, depending on your internet connection), **close all open command prompts, powershell windows, and editors with a built-in console/prompt**. Otherwise, the next command will not work.&#x20;
{% endtab %}

{% tab title="Linux" %}
On Linux, the pre-requisites are much simpler in a way. A lot of modern systems (such as Ubuntu, since 16.04) already come with python 2.7 pre-installed. For some other systems, you might have to fiddle with it to either get python 2.7 installed, or to install both 2.7 and 3.x simultaneously. Google will be your friend.&#x20;

As for the C++ build tools, that's installed using the simple command: `sudo apt-get install build-essential` for most debian-based systems. For others, look towards your package manager and specificall "GCC build tools". Your mileage may vary but hey, you're using Linux, you should know this stuff.&#x20;
{% endtab %}

{% tab title="Mac OS" %}
As of writing this page, MacOS versions seem to all come pre-built with Python 2.7 on the system. You will, however, need the C++ build tools.&#x20;

* Install [XCode](https://developer.apple.com/xcode/download/)
* Once XCode is installed, go to **Preferences**, **Downloads**, and install the **Command Line Tools**.

Once installed, you're ready to continue.&#x20;
{% endtab %}
{% endtabs %}

## Installing enmap

To install Enmap in your project, all you need to to is run the following command in your project folder:&#x20;

```
npm i eslachance/enmap#v3
```

This may take a few minutes, then you're ready to use it.&#x20;