Install Fest Instructions
Welcome to your Burlington Code Academy software program!
We will use several tools during class, please see the instructions for installing the specific tools you will need based on your operating system.
Please note that we can support students using the following operating systems: - Windows 10+ - Apple MacOS Mojave 10.14+
Windows Installation
The instructions below will walk you through installing the following tools:
- Node.js JavaScript Engine
- Git Version Control System
- Visual Studio Code Text Editor
- Cmder Terminal Emulator
- MongoDB and Mongo Compass GUI
- Heroku Command-line Tools
You will also be show how to sign up for a user account on the following services:
- GitHub
- Heroku
Node.js JavaScript Engine
- Visit the Node.jsĀ® homepage at https://nodejs.org/en/
- Click and download the installer for the Current version
- Run the managed installer from your Downloads folder
- Select the default options for installation location and packages
Git Version Control System
Git Command Line Tool Installation
- Visit the Git downloads page at https://git-scm.com/downloads
- Click on the link for Windows
- Run the installer from your downloads folder
- Select the default options
Github User Account
- Visit the Github Signup page at https://github.com/join
- Create a user account and select a unique user name.
- Optional: Read about Getting started with Github
Visual Studio Code Text Editor
NOTE: The tool we are going to use is Visual Studio Code
which is a free open-source editor with a strong developer community, made by Microsoft.
This is a different tool than Microsoft Visual Studio
which is a non-free proprietary tool for enterprise software teams.
Please make sure to download and install the correct tool, Visual Studio Code
- Download the Installer https://code.visualstudio.com/download
- Run the installer, accepting the default options
- Run the VS Code Application from the start menu or shortcut.
- Optional: Read the Node.js in VS Code Tutorial
Helpful VS Code Extensions for Node.js
The following extensions for VS Code are helpful, but optional. You can learn how to install extensions from the official documentation.
Cmder Terminal Emulator
- Visit https://cmder.net
- Click "Download Full"
- Save the ZIP file and unzip it into your home directory or into
C:\cmder
- if your username is
Alice
you should now haveC:\Users\Alice\cmder\Cmder.exe
- if your username is
- Right-click
Cmder
and select "Create Shortcut" - Click and Drag that shortcut to the desktop
- Double-click the shortcut to open the terminal
- Press Win-Alt-P (or select "Settings..." from the window's menu) and make sure the "startup task" is set to
{cmd::Cmder as Admin}
MongoDB and Mongo Compass
MongoDB Service
- Visit the MongoDB installation page at https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/
- Download the MongoDB Community Server at: https://www.mongodb.com/try/download/community
- Run the installer from your Downloads folder
- Choose the "Complete" setup type from the installation wizard
- On the "Service Configuration" pane, select "Run Service as Network Service User"
MongoDB Compass
NOTE: MongoDB Compass is usually installed automatically when MongoDB Community Edition is installed via the official installer. Only follow the instructions below if something goes wrong during the Community Edition installer and Compass failed to install.
- Visit the MongoDB Compass installation instructions https://docs.mongodb.com/compass/master/install/
- Download MongoDB Compass from https://www.mongodb.com/try/download/compass
- Run the installer from your Downloads folder
- Accept the default values for installation location and options
Heroku Command Line Tools
Heroku User Account
For the Heroku Command Line Tools to work correctly you will need a Heroku user account.
- Visit https://signup.heroku.com/
- Create a new user account
- Optional: Read about Getting started with Node.js on Heroku
Heroku Command Line Tools Installation Steps
- Visit the Heroku Command Line Tools documentation page at https://devcenter.heroku.com/articles/heroku-cli
- Download the installer for Windows at https://cli-assets.heroku.com/heroku-x64.exe
- Run the installer from your Downloads folder and accept the default options, you may be asked to login to Heroku, so if you have not yet signed up for the service, do so.
Login to the Heroku service from the command-line tool by running the command below in a terminal window, you will need an active user account prior to running this command.
heroku login
Apple MacOS Installation
The instructions below will walk you through installing the following tools:
- Visual Studio Code
- Apple Command Line Tools
- Homebrew package manager
- Node.js JavaScript Engine
- Heroku Command-line Tools
- MongoDB and Mongo Compass GUI
You will also be show how to sign up for a user account on the following services:
- GitHub
- Heroku
Visual Studio Code Text Editor
NOTE: The tool we are going to use is Visual Studio Code
which is a free open-source editor with a strong developer community, made by Microsoft.
This is a different tool than Microsoft Visual Studio
which is a non-free proprietary tool for enterprise software teams.
Please make sure to download and install the correct tool, Visual Studio Code
- Download the Installer https://code.visualstudio.com/download
- Expand the Application within your
Downloads
folder. - Move the
Visual Studio Code.app
package to your/Applications
directory - Run the VS Code Application from the
/Applications
directory, do not run it from within yourDownloads
folder as you will not be able to use all the features - Add VS Code to your Dock by right-clicking on the icon to bring up the context menu and choosing Options, Keep in Dock
- Install the
code
command-line tool by performing the following- Open VS Code if you have not yet done so.
- Open the
Command Palette
by typing the following CMD-SHIFT-P - Type
install code command
and then typing RETURN - You may be asked to confirm you want to install the
code
command - See the official documentation for additional help
- Optional: Read the Node.js in VS Code Tutorial
Helpful VS Code Extensions for Node.js
The following extensions for VS Code are helpful, but optional. You can learn how to install extensions from the official documentation.
Apple Xcode Command-Line Tools
You will be using the default Terminal.app program to access command-line tools and execute programs throughout the course. If you have never opened the Terminal.app program before, visit this documentation page from Apple to learn how to do so.
Some of the command-line tools which used to be installed by default on MacOS are not installed optionally by using the xcode-select --install
command within the Terminal.app.
Follow the instructions below to install the tools required to be able to use additional developer tools, including MacOS Homebrew.
Open the MacOS Terminal and type
xcode-select --install
In the dialog box, click the Install button
You may be asked to enter your user login password
Wait several minutes for the download and installation to complete
MacOS Homebrew
Homebrew is a package manager for MacOS that lets you install tools directly from the Terminal. Once it's installed, it's generally easier to use Homebrew than to use a web browser and graphical installer app.
These instructions are for recent versions of MacOS (MacOS v10.14 Mojave or newer). If these do not work for you, don't worry we can assist you in installing the tools another way.
Install Homebrew
- Visit https://brew.sh
- Find the section labeled "Install Homebrew"
- Copy the entire line beneath "Install Homebrew"
- Open a Terminal.app window and paste the copied text
The text will look like this, please refer to the text from the https://brew.sh homepage
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Enter your password and hit Return as prompted, you will not see the characters as you type your password, this is default behavior in command-line applcations.
Node.js (JavaScript)
We prefer to use the brew
command to install Node.js. If you have not yet installed Homebrew in the instructions above, please do so.
Install Node.js using Homebrew
Open a Terminal.app window and type the following, followed by Return
brew install node
Confirm that Node.js is installed by typing the command below, followed by Return
node --version
You should see a version string such as v16.1.0 or similar
v16.1.0
Alternative Install of Node.js
If you cannot install Homebrew or have a problem installing Node.js using Homebrew, you can instead use the Node.js foundation installation steps.
- Visit the Node.js homepage at https://nodejs.org/en/
- Version v16.1.x Current is preferred (the button on the right side)
- Check that a version of Node.js is installed
Open a Terminal.app window and type the command below followed by Return
node --version
You should see a version string such as v16.1.0 or similar
v16.1.0
Git Version Control System
Git Command Line Tool
The version control tool Git is installed when you completed the command xcode-select --install
. If for some reason you were unable to install the Xcode command-line tools, then you can install Git manually by following the instructions below.
- Visit the Git Downloads page at https://git-scm.com/downloads
- Download the installer for MacOS
- Run the installer from the Downloads folder, you may be asked for your password
Confirm that Git is installed by running the command below followed by Return
git --version
You should see something like the following, any version above v2.0 is fine
git version 2.30.0
Github User Account
- Visit the Github Signup page at https://github.com/join
- Create a user account and select a unique user name.
- Optional: Read about Getting started with Github
Heroku Command Line Tools
Heroku User Account
For the Heroku Command Line Tools to work correctly you will need a Heroku user account.
- Visit https://signup.heroku.com/
- Create a new user account
- Optional: Read about Getting started with Node.js on Heroku
Heroku Command Line Tools Installation Steps
- Visit the Heroku Command Line Tools documentation page at https://devcenter.heroku.com/articles/heroku-cli
Install the tolls for MacOS by running the command below in a Terminal.app window
brew tap heroku/brew && brew install heroku
Confirm that the Heroku command-line tools are installed by running the command below
heroku --version
You should see something like the following output, any version above
v7.50.0
is fineheroku/7.54.0 darwin-x64 node-v12.21.0
Login to the Heroku service from the command-line tool by running the command below, you will need an active user account prior to running this command.
heroku login
MongoDB and Compass
MongDB and it's GUI Compass will be used later in the course when we dive in to databases.
Check the documentation on this page for Mac install instructions.
MongoDB Service
Run the following commands one after the other in your terminal to install mongoDB
brew tap mongodb/brew brew install mongodb-community
Then run the following command to test it:
brew services start mongodb/brew/mongodb-community
If you run into any issues please let one of our instructors or TAs know
MongoDB Compass Graphical Interface
- Visit the MongoDB Compass installation instructions https://docs.mongodb.com/compass/master/install/
- Download MongoDB Compass from https://www.mongodb.com/try/download/compass
- Run the installer from your Downloads folder
- Accept the default values for installation location and options