android.moparisthebest.org/source/docs/setup/index.markdown

---
layout: page
title: Octopress Setup
date: July 18 2011
sidebar: false
footer: false
---

First, I want to stress that **Octopress is a blogging framework for hackers**.
You should be comfortable running shell commands and familiar with the basics of Git.
If that sounds daunting, Octopress probably isn't for you.

## Before You Begin

You'll need to [install Git](http://git-scm.com/) and set up your Ruby environment.
**Octopress requires Ruby 1.9.3** which you can easily install with [rbenv](https://github.com/sstephenson/rbenv) or [RVM](http://rvm.beginrescueend.com).
You can't use both rbenv and RVM on the same system, as they are competing Ruby environment managers, so choose one.

### Using rbenv

If you don't have rbenv, [Install rbenv](https://github.com/sstephenson/rbenv#section_2) and [install ruby-build](https://github.com/sstephenson/ruby-build), then install Ruby 1.9.3.

```sh
rbenv install 1.9.3-p0
```

### Using RVM

If you don't have RVM, [Install RVM](/docs/setup/rvm) and then install Ruby 1.9.3.

```sh
rvm install 1.9.3 && rvm use 1.9.3
```


## Setup Octopress

```sh
git clone git://github.com/imathis/octopress.git octopress
cd octopress    # If you use RVM, You'll be asked if you trust the .rvmrc file (say yes).
ruby --version  # Should report Ruby 1.9.3
```

If `ruby --version` doesn't say you're using Ruby 1.9.3, you may want to [revisit your RVM installation](/docs/setup/rvm).

Next, install dependencies.

```sh
gem install bundler
rbenv rehash    # If you use rbenv, rehash to be able to run the bundle command
bundle install
```

Install the default Octopress theme.

``` sh
rake install
```

## Next Steps

- [Set up deployment](/docs/deploying)
- [Configure your blog](/docs/configuring)
- [Start blogging with Octopress](/docs/blogging)