All attendees

There are two key preparation steps:

  1. Back up your data. It is possible to delete things by mistake, it's best to have a backup.
  2. Ensure you have a working bash shell and key tools installed - see below for your operating system's instructions.

OSX

Although Terminal is always ready to go on OSX, you may still need to install Xcode CLI tools.

  1. Open Terminal: Applications → Utilities → Terminal
  2. Run bash --version ...you should see a message like GNU bash, version 3.2.57. In the unlikely event this does not work, try installing iTerm.
  3. Run git --version ...if you haven't installed the Xcode CLI tools, it should prompt you to install them.
  4. Once Xcode has been installed, confirm the following commands work:
    • git --version
    • make --version
    • curl -I https://command-line.net

If anything is missing, try opening Xcode from the Applications folder. Sometimes it needs you to accept Terms & Conditions before you can run the CLI tools.

Linux

  1. Find "Terminal" in your Linux application menu. The exact name varies but it's usually pretty easy to find.
  2. Run bash --version ...you should see a message like GNU bash, version 4.3.30 ...in the unlikely event this does not work, you'll need to investigate installing a bash shell on your Linux distribution.
  3. Confirm the following commands work:
    • git --version
    • make --version
    • curl -I https://command-line.net

If anything is missing, install them the usual way for your Linux distribution.

Windows

Some sizeable downloads are required for all versions of Windows, so do this ahead of time.

  • The recommended option for Windows 10 is WSL
  • All versions of Windows can use Cygwin

Other shells including Git Bash, cmd and Powershell are not suitable.

WSL (Windows Subsystem for Linux)

Windows 10 includes Windows Subsystem for Linux, which is a long name for a bash shell. See the blog post Using WSL on Windows 10 for setup and configuration suggestions. If in doubt just choose the Ubuntu distribution. Don't forget to add your WSL username and password to your password safe.

Once you have WSL running, confirm the following commands work:

  • git --version
  • make --version
  • curl -I https://command-line.net

Cygwin

  • Download the installer from cygwin.com
  • Follow the instructions for a fresh install.
  • At the "select packages" stage, add the following packages by searching, then changing them from "skip" to install (it will show the version number):
    • (editor) vim
    • (editor) nano
    • (development) git
    • (development) make
    • (python) python (2 not 3)
    • (net) ping
    • (net) curl
    • (web) wget
    • (utils) tree
    • (utils) colordiff
    • (utils) dos2unix
  • When it asks about "resolving dependencies" say yes, it'll download any extras required to install the options you specified.
  • When everything's installed, run Cygwin.
  • Run the command bash --version ...you should see a message like GNU bash, version 4.3.42
  • To orient yourself to the location Cygwin has been installed, run cd ~ && cygstart. This should open Windows Explorer in your bash home directory.
  • Note that your firewall may prompt for permission multiple times when you start Cygwin and run commands for the first time. Although it's a bit annoying this is normal, as bash is running lots of small, separate programs.
  • Confirm the following commands work:
    • git --version
    • make --version
    • curl -I https://command-line.net
    ...if any of these fail, run Setup again and add those packages.