Tech docs template Beta
Table of contents

Prerequisites for Macs

You must have the following set up on your mac laptop:

  • administrator rights on your laptop
  • Xcode command line interface tools
  • Ruby
  • Middleman static site generator

Administrator rights on your laptop

Raise a ticket on the GDS Web Help Desk to request administrator rights on your laptop.

You must be a Government Digital Service employee to do this.

Install Xcode command line interface tools

These instructions assume that you are the Managed Software Centre on your Mac.

  1. Go to the Managed Software Centre on your Mac.
  2. Select Updates.
  3. Install all required updates.
  4. Search for xcode in the search field in Updates.
  5. Install Xcode x.x.x or update if necessary.

OR

  1. Go to Apple Developer Downloads.
  2. Search for “xcode”.
  3. Select the appropriate Command Line Tools (macOS x.x) for Xcode x.x and download the file.
  4. Install the file.

Install Ruby

Ruby is installed globally. This means that you can run the install command from any location on your local machine rather than from within a specific folder.

You can install Ruby in multiple ways, for example using Ruby Version Manager (RVM) or rbenv. These instructions assume you are using RVM.

  1. Run the following in the command line interface to install the ruby version manager:

    `\curl -sSL https://get.rvm.io | bash -s stable --ruby`
    
  2. Run rvm install ruby-x.x.x to install the latest version of Ruby. The current x.x.x is 2.6.1.

Install Middleman

Middleman is installed globally. This means that you can run the install command from any location on your local machine rather than from within a specific folder.

Run the following in the command line interface to install Middleman:

gem install middleman