Install Octopress on Windows 8.1

The idea of how I finally install Octopress on Windows 8.1 is because I did it on Mac already.

And as always, I was being curious about Windows 8.1 operating system.

Simply “what about if I install Octopress on Windows” question. Then I tried to google around, and I write the method to install Octopress on Windows 8 that works for me below.

A note before we install Octopress on Windows 8.1: I dual booted my computer that’s why you see F:\> path in the video, in yours, should be on C:\>.

Install Octopress on Windows 8.1 Video

Step by step to install:

In this tutorial, I am using chocolatey, Windows sort of Homebrew version, enabling us installing stuff easier in Command Prompt.

Using this Windows Command tool is so fun, that I enjoy doing it, this is one of advantage of blogging with Octopress, you don’t need any FTP client to deploy.

See this FileZilla SFTP tutorial if you are interested.

1. Open your Command Prompt, by searching “cmd” on search charm bar, and right click it, select, “Open as Administrator”.

Open "CMD" Command Prompt
Open “CMD” Command Prompt

2. Install chocolatey inside Command Prompt, by clicking the copy icon on their website, and paste it in your Command Prompt.

Click this copy icon on Chocolatey website
Click this copy icon on Chocolatey website
Commands to install Chocolatey
Commands to install Chocolatey
@powershell -NoProfile -ExecutionPolicy unrestricted -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%systemdrive%\chocolatey\bin

2. Install Git, by typing choco install git. Or shortcut:

Type "cinst git" to install Git with Chocolatey
Type “cinst git” to install Git with Chocolatey
cinst git

Now when you type,

git --version

It will say, ‘git’ is not recognized as an internal or external command, operable program or batch file.

Don’t worry, just exit your Command Prompt, and restart it again.

Now when you type

git --version

you should see:

git version 1.9.0.mysysgit.0

3. Install Ruby 1.9.3 from Rubyinstaller.org/downloads.

Click here to download directly from Rubyinstaller.org and choose the file yourself, as shown below.

Install Ruby 1.9.3
Install Ruby 1.9.3

Install it in your computer.

4. Now, when you type,

ruby --version

you will see ‘ruby’ is not recognized as an internal or external command, operable program or batch file.

To solve this, go to your C folder (mine is in F, because of dual-boot). So go to C:\Ruby193\bin folder.

Copy Ruby application path
Copy Ruby application path
Copy Ruby location
Copy Ruby location
System Properties
System Properties
Environment Variables
Environment Variables
Editing user variable
Editing user variable

Scroll down, and you should see ruby application, select, and right click it, go to “Properties”.

Here, copy the “Location”.

The right click on “This PC” and select on “Properties”, “Advanced system settings”.

In “System Properties” make sure you are on “Advanced”, then click on “Environment Variables” button on the bottom right.

In “Environment Variables” select on “Path”, click “Edit”

In “Edit User Variable”, in “Variable value”, add the ruby application path we coped above right after semicolon, and after pasted, add semicolon again at the end.

Click, Ok, Ok and Ok.

Now when you type

ruby --version

it should say ruby 1.9.3p545 (2014-02-24) [i386-mingw32]

5. Install Ruby Development Kit, by typing cinst ruby.devkit in your Command Prompt.

cinst ruby.devkit
Install Ruby Development Kit
Install Ruby Development Kit

Now, that we’ve set up our development environment, we will install Octopress, see official setup guide here.

In this tutorial I install it inside my “Documents” folder, so the command will be:

cd Users\Kim\Documents

Change “kim” to your Username.

1. Clone Octopress by copy and pasting

Install Octopress on Windows 8.1
Install Octopress on Windows 8.1
git clone git://github.com/imathis/octopress.git blogweb6octopress

Change “blogweb6octopress” to your site name or any custom names.

2. Then, typing:

cd blogweb6octopress

Then these 3 commands one by one:

gem install bundler
bundle install
rake install

To see your local Octopress website, type, “rake generate && rake preview”

Open it on localhost:4000.

Octopress Windows 8
Octopress Windows 8

To start creating post and other, see Octopress documentations.

That’s it, let me know how you did differently.

3 thoughts on “Install Octopress on Windows 8.1”

Comments are closed.