## Contents

If you need help:

### Installing Without Homebrew

This is described in detail in this video tutorial.

First you need to know which processor architecture your computer has. If you're not sure, you can use Terminal.app to find out:

Open Terminal.app and type in the following command:

 1 uname -m 

Common values are i386 (32-bit) and x86_64 (64-bit). If you have something different, you'll need to ask Google about the details.

If you don't have a directory in your home directory called bin, make one now:

 1 mkdir ~/bin 

Next, get the latest release from GitHub, making sure to get the one that is both for Mac and for your architecture:

 1 2 cd ~/Downloads tar -xzvf exercism-mac-64bit.tgz 

Move the exercism binary to the bin directory:

 1 mv exercism ~/bin/ 

Check if ~/bin is on your path:

 1 echo $PATH  Look for a section between two colons that looks like /Users/<your-username>/bin or ~/bin. If it's not there, you need to add it. In order to do so, you'll need to know which shell you use, so that you can add it to the correct config. Find out, by running:  1 echo$SHELL 

If it says /bin/bash, then you're using the default that ships with the Mac. If not, you'll need to replace .bash_profile with the name of the correct config file.

 1 echo 'export PATH=~/bin:\$PATH' >> ~/.bash_profile 

Finally, source your shell config:

 1 source ~/.bash_profile 

You should now have access to the exercism command:

 1 exercism --version 

### Continue

You can now continue by choosing a language.

## Windows - Manual Installation

What follows are instructions that work for installing exercism on Windows 7 or Windows 8. Instructions for other versions of Windows may differ slightly, but the principle will be the same.

For a visual guide, see this screencast.

NOTE: You will need Admin privileges for some of the steps detailed below. If you don't have them, get someone with those privileges to do the install for you.

### Short Version

1. Download the zip file that corresponds to your Windows installation (32-bit or 64-bit).
2. Extract exercism.exe to a folder of your choice.
3. Add that folder to your PATH.

### Before you start

Before you download exercism you will need to determine whether you are running a 32-bit or 64-bit version of Windows. You can do this as follows:

1. Open the Windows Control Panel
1. In Windows 7 this can be accomplished by clicking on "Start" and selecting "Control Panel" from the list on the right
2. In Windows 8 this can be accomplished by right clicking on "Start" and selecting "Control Panel" from the menu that appears
2. Select "System"
3. A reasonable amount of information is displayed, including the "System type". This will tell you whether you have a 32-bit or 64-bit Operating System and whether you have a 32-bit or 64-bit processor
4. NOTE 1 It is possible to install a 32-bit version of Windows on a 64-bit processor. You need to take note of the version of the Operating System, not the processor
5. NOTE 2 Keep this System window open as you will make use of it further down

Determine which is the appropriate exercism Windows patch release for your Operating System (exercism-windows-32bit.zip for a 32-bit Operating System or exercism-windows-64bit.zip for a 64-bit Operating System) and download it from here

### Copying exercism.exe to its own folder

1. Open File Explorer and create a new folder where you want to place exercism.exe (e.g. C:\Exercism or C:\Program Files\Exercism)
2. Open the downloaded exercism-windows-*.zip file, select exercism.exe and copy it into the folder you created in the previous step

### Adding the executable's directory to PATH

Adding the location of exercism.exe to the PATH variable allows you to call exercism from any command line location, i.e.:

 1 C:\Users\MyName> exercism help 

Instead of having to type the full\path\to\exercism.exe every time:

 1 C:\Users\MyName> C:\Program Files\Exercism\exercism.exe help 

Before you start, you can create a backup of your PATH variable by opening cmd.exe (Command Prompt) and typing the following command:

 1 C:\Users\MyName> PATH > yyyy-mm-dd_PATH_backup.txt 

This way you have a copy of PATH as it existed before you start the below steps.

The following instructions will append the location of the exercism.exe file to the current value in the PATH variable. The directories in the PATH are separated by semicolons, so you should add a semicolon to the end of what you currently have, and then add the location of exercism.

1. WARNING: You are about to update your "PATH" user or system variable. You must carefully follow the instructions below, as deleting any existing paths could have serious implications for your Windows installation. This is not difficult, just make sure you don't rush through this stage and miss a step. If you are worried about making the change below, I suggest you choose to make exercism available just for you as the impact of any mistake should be significantly less.
2. In the System window left open in "Before you start", Select "Advanced system settings"
3. If you are asked "Do you want to allow the following program to make changes to this computer?" click on "Yes"
4. Click on "Environment Variables..."
5. At this point you have the option of making exercism available just for the current user or for every user:
1. Only for the current user: In the upper list, "User variables for <your username>", find and select "PATH" and click on "Edit...". If you can't find "PATH", click on "New..." and type "PATH" into "Variable name"
2. For every user: In the lower list, "System variables", find and select "Path" and click on "Edit..."
6. WARNING: If you are adding a path to a previously existing list:
1. DO NOT start typing, as the current "PATH"/"Path" value is selected and will be deleted when you type. If this warning is too late, YOU MUST click on "Cancel" and go back to the previous step
2. Press the "End" key to take you to the end of the value
3. type in a semi-colon ";"
7. Type in the path to where you have placed exercism.exe (you can paste in the location if you open the exercism folder in Explorer, click in the location bar at the top and copy the text)
8. NOTE: If you can't remember where you have placed the file, search for "exercism.exe" in Explorer, open the folder by right-clicking on exercism.exe and clicking on "Open file location", then follow the instructions in the previous step to copy and paste the location into the PATH value

### Running exercism

1. Open a command line interface (CLI) by clicking on "Start", typing "cmd" into the search bar and pressing enter
2. In the resulting window type in "exercism" and press Enter
3. If all is well you should be shown information on how to use exercism

### Continue

You can now continue by choosing a language.

If you need further help:

## Want to add more help topics?

The code for this documentation is in the exercism.io repository on GitHub. Submit a pull request or open an issue with suggestions!

(Check out the ./x/docs/cli.rb and ./app/views/site/cli.erb files.)