Skip to content

Installation Instructions 2.0 on Windows

Mariano Eduardo Rodriguez edited this page Nov 7, 2022 · 8 revisions

The current installation instructions here: http://octopress.org/docs/setup/ don't quite work for a fresh install on windows machines. You will hit all sorts of time consuming error messages.

So below is the installation procedure that works for Windows!

  1. Install Git - make sure you choose the option to add Git to Path
  2. Install Ruby 1.9.3 - make sure you choose the option to add Ruby to Path
  3. Open up a Command Prompt and execute the following: SET HOME=%USERPROFILE%

You next need to get an historic version of Ruby Gems installed (v2.3.0) The latest version of Ruby Gems at the time of writing is version 2.4.7 which doesn't work on windows.

So you need to do this:

  1. Install the latest version of RubyGems
    • download it from the link above and extract it to a permanent location.
    • open a command prompt, cd to that directory
    • type ruby setup.rb and hit enter.
  2. Downgrade the version of RubyGems to version 2.3.0.
    • open a command prompt
    • type gem update --system 2.3.0 and hit enter.

You next need to install the Ruby Build tools

  1. Download DevKit-tdm-32-4.5.2 from here
  2. Extract it to somewhere permanant
  3. open a command prompt
    • cd to that directory
    • type ruby dk.rb init and hit enter
    • type ruby dk.rb install and hit enter

You can now proceed with setting up OctoPress, from the command prompt:

  1. git clone git://github.com/imathis/octopress.git octopress
  2. cd octopress
  3. gem install bundler
  4. bundle install
  5. rake install

Happy OctoPressing!

  • And if you hit any issues with installing on Windows, feel free to give me a mention, i've probably hit the same before :) (@Dazinator)