Skip to main content
Table of contents

Set up your local machine

The following instructions assume that you have a mac laptop.

You must set up the following on your local machine:

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

Administrator rights on your laptop

If you are a Government Digital Service (GDS) employee, raise a ticket on the GDS Web Help Desk to request administrator rights on your laptop.

If you are not a GDS employee, follow your internal IT processes.

Install Xcode command line interface tools

  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.

If you have a software centre for your department, you should be able to install the Xcode command line tools through this.

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 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 to install Middleman:

gem install middleman
This page was last reviewed on 3 October 2019. It needs to be reviewed again on 4 October 2019 by the page owner #docs-repos .
This page was set to be reviewed before 4 October 2019 by the page owner #docs-repos. This might mean the content is out of date.