Merge pull request #748 from meteor/new-installer

Document new install method

Author: renanccastro

_config.yml

@@ -26,6 +26,7 @@ sidebar_categories:
   null:
     - index
     - changelog
+    - install
   API:
     - api/core
     - api/pubsub

source/index.md

@@ -17,6 +17,8 @@ Meteor is a full-stack JavaScript platform for developing modern web and mobile
 
 <h2 id="learning-more">Meteor resources</h2>
 
+1. First, learn how to install meteor in the [installation section](/install.html).
+
 1. The place to get started with Meteor is the [tutorials page](https://www.meteor.com/developers/tutorials).
 
 1. [Meteor Examples](https://github.com/meteor/examples) is a list of examples using Meteor. You can also include your example with Meteor.

source/install.md

@@ -0,0 +1,44 @@
+---
+title: Install
+---
+Meteor currently supports **OS X, Windows, and Linux**. Only 64-bit is supported.
+
+### Prerequisites and useful information
+
+- Meteor requires Node.js 8 or newer installed for running the npm installer.
+- Meteor supports Windows 7/Windows Server 2008 R2 and up.
+- Disabling antivirus (Windows Defender, etc.) will improve performance.
+- For compatibility, Linux binaries are built with CentOS 6.4 i386/amd64.
+- iOS development requires the latest Xcode.
+
+### Installation
+
+Install the latest official Meteor release from your terminal:
+
+```bash
+npm install -g meteor
+```
+
+If your user doesn't have permission to install global binaries, and you need to use sudo, it's necessary to append *--unsafe-perm* to the above command:
+
+```bash
+sudo npm install -g meteor --unsafe-perm
+```
+
+We strongly discourage the usage of Node.js or Meteor with root permissions.
+Only run the above command with sudo if you know what you are doing.
+
+If you only use sudo because of a distribution default permission system, [check this link for fixing it](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally).
+
+### Legacy Installation Method
+
+For Linux and OS X, we are still providing the legacy installation method which uses a bash script and doesn't depend on Node.
+
+```bash
+curl https://install.meteor.com/ | sh
+```
+
+This installation method is not maintained anymore, and you should always use the NPM one.
+
+
+