Installation guide
Last updated
Last updated
This guide will explain how to install all the software you need to start the course.
Before you start you should read the guide to make sure your computer is appropriate. This is especially true for Windows users, since you'll need a Linux environment for most of this guide to work.
If you hit any problems check the .
We'll be using a "package manager" to install most things. Package managers are software you use to install other software. They make it easier to install lots of things at once and keep track of everything you have. This is a more structured way than just going to a website, finding the right link and downloading an installer.
If you're using Linux (even on Windows) you should have the apt package manager already, since it's the standard way to install things on most Linux distributions.
Macs don't come with a package manager, so you'll need to install before anything else.
Here's a quick summary of the things we need. We'll cover what each one is and how to install it below.
Git
Node
npm
iTerm2 (Mac) or Windows Terminal
VS Code (or your preferred editor)
Chrome/Edge/Firefox
If you need to install Git you can use your package manager.
Node is a version of JavaScript that you can run on your own computer. JS is usually limited to running on web pages inside of a web browser, but Node lets you run JS code anywhere.
You don't want to install this with a package manager, since it's a language not a normal program. Most package managers have out-of-date versions.
You may have to restart your Terminal afterwards.
You can now use Volta to install different versions of Node. We require Node version 18 for our programme, so you need to specify that:
Volta should install Node 18 and automatically start using it. You can check it worked by running this command:
npm is yet another package manager (it stands for "Node Package Manager"). It's used for installing JavaScript code inside your projects. Luckily npm comes with Node, so you don't have to install it.
If for some reason you don't have it, or it is very out-of-date, you can install it with Volta too:
You may need to install the "command-line tools". This allows you to run code . in your Terminal to open the current folder in your editor (this is very useful!).
Try running code --version. If you get an error you need to open VS Code, hit cmd-shift-p (or ctrl-shift-p on Windows/Linux) to open the command-palette, then search for “shell”. Select the option that says: Shell Command: Install ‘code’ command in PATH.
It's a good idea to have a few different browsers installed for testing your websites, as they don't always work in exactly the same way.
You can run our installation checker script to make sure everything is installed correctly:
This will tell you what version (if any) you have of each required program. You want at least these minimum versions: Node 18, npm 8.
Every computer is different and has a different combination of operating system, version, etc. This means it's likely you'll encounter some problems installing at least one thing. This can be frustrating, but try to take a deep breath and work through the issue.
The most important skill to learn as a developer is how to carefully read an error message and figure out what went wrong. So in a way fixing problems at this stage is great practice starting out in your career!
Read the error message. If it's very long make sure you scroll right to the top.
If the error message suggested a solution try that first. If it pointed out an obvious issue (like a mispelled command) try correcting it and running again.
If the error isn't self-explanatory google the exact message plus the general technology. For example is Homebrew fails to install with a message like Failed during git fetch... then search for Homebrew "Failed during git fetch". The quotes tell Google you want the results to include that exact string.
Don't be afraid to try suggestions off the internet. You'll find yourself copy/pasting things from Stack Overflow throughout your career. However bear in mind that Terminal commands can be dangerous, so be a little cautious and make sure you read things before blindly pasting them.
Some problems come up again and again, so it's quicker to list them here than have everyone google them.
Did your Volta install script succeed, but you cannot actually use it (e.g. you get Command not found when running volta install node)?
This means the Volta program was not added to your Terminal's PATH variable. PATH is a list of every command-line program that is installed. It's where your Terminal looks for available commands whenever you type anything (e.g. ls and cd are listed inside PATH somewhere).
Volta is supposed to automatically do this, but sometimes it does so in the wrong config file (e.g. if you have both Bash and Zsh configs). You can manually add the required lines. First determine which shell you're using with:
This will print something like /bin/zsh or /bin/bash. If your shell is Zsh (the default on modern Macs) then you want to edit the .zshrc config file. If it is Bash you either want the .bashrc or .bash_profile config files.
These config files live in your "home directory". The tilde symbol (~) is a shortcut for this directory. You can list everything inside of it with:
You should be able to see the config file you need in there. Open it in your text editor with:
and add the following lines (there might be existing config; you can add these lines anywhere):
Restart your Terminal and you should now be able to use the volta program.
Homebrew uses Git to download all of the information it needs about packages. This homebrew/core repo is very big, and can fail to download. You may see an error like:
This usually means the download was interrupted midway through. You can try re-running the same command in case it was a fluke. However we've found that some Internet Service Providers enable "protection" settings that mess with large Git downloads.
The easiest way to verify this is to tether your laptop to your phone's hotspot and retry. If that works you may want to investigate your ISPs settings and see if there's something you need to disable.
is a program for tracking changes to the code you write. Most systems come with this installed, but it's worth making sure you have a relatively recent version. You can run this in your terminal to check the version:
You will need to tell Git your and . It uses these to record who wrote each bit of code in a project.
You should make sure the email matches your email on GitHub, so that you don't end up with multiple versions of yourself committing to a project. If you want to keep your email private with a "no-reply" email for use with Git.
We'd recommend going through GitHub's , and guides as there are some extra bits of setup you probably want to do.
We'll install Node with , which is a tool for managing Node versions. This command will download their install script (with curl) then pass the script to bash to run it:
You probably want to install a nicer Terminal program than the default. This is mostly down to personal preference, but you'll be spending a lot of time in the Terminal so it's worth finding something you like. We also recommend .
is great on macOS. You can either install it manually from their website or with Homebrew:
The new Windows Terminal is designed for Linux-on-Windows (WSL). They recommend you install it from .
You'll be writing a lot of code, so you'll want a nice editor. We recommend . It's probably easiest to install this via the website.
As a web dev most of the software you write will run in a web browser. You'll need any modern browser—ideally , or (Safari doesn't have the best developer tools).