enigma-bbs/docs/installation/windows.md

---
layout: page
title: Windows Full Install
---

ENiGMA½ will run on both 32bit and 64bit Windows. If you want to run 16bit doors natively then you should use a 32bit Windows.  


### Basic Instructions

1. Download and Install [Node.JS](https://nodejs.org/en/download/). 

	1. Upgrade NPM : At this time node comes with NPM 5.6 preinstalled. To upgrade to a newer version now or in the future on windows follow this method. `*Run PowerShell as Administrator`

		`*Inital Install`
		```Powershell
		Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
		npm install -g npm-windows-upgrade
		```
		`*Upgrade`
		```Powershell
		npm-windows-upgrade
		```

		Note: Do not run `npm i -g npm`. Instead use `npm-windows-upgrade` to update npm going forward. 
		Also if you run the NodeJS installer, it will replace the node version.:

	2. Install [windows-build-tools for npm](https://www.npmjs.com/package/windows-build-tools)
		`*This will also install python 2.7`
		```Powershell
		npm install --global --production windows-build-tools
		```
		

2. Install [7zip](https://www.7-zip.org/download.html).

	*Add 7zip to your path so `7z` can be called from the console
	1. Right click `This PC` and Select `Properties`
	2. Go to the `Advanced` Tab and click on `Enviromental Varibles`
	3. Select `Path` under `System Varibles` and click `Edit`
	4. Click `New` and paste the path to 7zip
	5. Close your console window and reopen. You can type 7z to make sure it's working.

3. Install [Git](https://git-scm.com/downloads) and optionally [TortoiseGit](https://tortoisegit.org/download/). 

4. Clone ENiGMA½ - browse to the directory you want and run 
	```Powershell
	git clone "https://github.com/NuSkooler/enigma-bbs.git"
	```
	Optionally use the TortoiseGit by right clicking the directory and selecting `Git Clone`.
    

5. Install ENiGMA½.
	1. In the enigma directory run 
	```Powershell
	npm install
	```
	2. Generate your initial configuration: `Follow the prompts!`
	```Powershell
		node .\oputil.js config new
	```
	3. Edit your configuration files in `enigma-bbs\config` with [Notepad++](https://notepad-plus-plus.org/download/) or [Visual Studio Code](https://code.visualstudio.com/Download)
	4. Run ENiGMA½
	```Powershell
		node .\main.js
	```
	

6. Profit!