enigma-bbs/docs/installation/windows.md

72 lines
2.4 KiB
Markdown
Raw Normal View History

2018-03-24 04:57:32 +00:00
---
layout: page
title: Windows Full Install
---
2018-03-24 06:03:27 +00:00
ENiGMA½ will run on both 32bit and 64bit Windows. If you want to run 16bit doors natively then you should use a 32bit Windows.
2018-03-24 04:57:32 +00:00
### Basic Instructions
1. Download and Install [Node.JS](https://nodejs.org/en/download/).
2018-03-24 06:16:26 +00:00
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`
2018-03-24 05:56:40 +00:00
2018-03-29 22:46:14 +00:00
`*Initial Install`
2018-03-24 06:18:13 +00:00
```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.
2018-03-29 22:46:14 +00:00
Also if you run the NodeJS installer, it will replace the node version.
2018-03-24 04:57:32 +00:00
2018-03-24 05:14:10 +00:00
2. Install [windows-build-tools for npm](https://www.npmjs.com/package/windows-build-tools)
2018-03-24 06:18:13 +00:00
`*This will also install python 2.7`
2018-03-24 05:26:48 +00:00
```Powershell
npm install --global --production windows-build-tools
```
2018-03-24 04:57:32 +00:00
2018-03-24 05:14:10 +00:00
2. Install [7zip](https://www.7-zip.org/download.html).
2018-03-24 05:19:50 +00:00
2018-03-24 06:03:27 +00:00
*Add 7zip to your path so `7z` can be called from the console
2018-03-24 05:58:56 +00:00
1. Right click `This PC` and Select `Properties`
2018-11-23 18:05:51 +00:00
2. Go to the `Advanced` Tab and click on `Environment Variables`
3. Select `Path` under `System Variables` and click `Edit`
2018-03-24 05:58:56 +00:00
4. Click `New` and paste the path to 7zip
2018-03-24 06:22:14 +00:00
5. Close your console window and reopen. You can type `7z` to make sure it's working.
2018-03-24 04:57:32 +00:00
2018-11-23 18:05:51 +00:00
(Please see [Archivers](/docs/archivers.md) for additional archive utilities!)
2018-03-24 05:14:10 +00:00
3. Install [Git](https://git-scm.com/downloads) and optionally [TortoiseGit](https://tortoisegit.org/download/).
2018-03-24 04:57:32 +00:00
2018-03-24 06:03:27 +00:00
4. Clone ENiGMA½ - browse to the directory you want and run
2018-03-24 05:29:19 +00:00
```Powershell
git clone "https://github.com/NuSkooler/enigma-bbs.git"
```
2018-03-24 06:06:29 +00:00
Optionally use the TortoiseGit by right clicking the directory and selecting `Git Clone`.
2018-03-24 04:57:32 +00:00
5. Install ENiGMA½.
2018-03-24 06:00:41 +00:00
1. In the enigma directory run
2018-03-24 06:06:00 +00:00
```Powershell
npm install
```
2018-03-24 06:08:22 +00:00
2. Generate your initial configuration: `Follow the prompts!`
2018-03-24 05:29:19 +00:00
```Powershell
node .\oputil.js config new
```
2018-03-24 06:11:37 +00:00
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)
2018-03-24 04:57:32 +00:00
4. Run ENiGMA½
2018-03-24 05:30:38 +00:00
```Powershell
node .\main.js
```
2018-03-24 04:57:32 +00:00
2018-03-29 22:46:14 +00:00
6. Look at [Production Installation](/installation/production) for maintaining ENiGMA½ when you are ready to go live.