2011-07-19 22:28:48 -04:00
---
layout: page
title: Octopress Setup
date: July 18 2011
sidebar: false
footer: false
---
2011-09-19 13:19:20 -04:00
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.
2011-07-19 22:28:48 -04:00
2011-09-19 13:19:20 -04:00
## Before You Begin
2011-08-02 00:40:15 -04:00
2011-09-22 15:40:40 -04:00
You'll need to [install Git ](http://git-scm.com/ ) and set up your Ruby environment.
**Octopress requires Ruby 1.9.2** wich you can easily install with [RVM ](http://rvm.beginrescueend.com ) or [rbenv ](https://github.com/sstephenson/rbenv ).
2011-12-10 06:17:12 -05:00
You can't use both rbenv and RVM on the same system, as they are competing Ruby environment managers, so choose one.
2011-07-19 22:28:48 -04:00
2011-09-22 15:40:40 -04:00
### Using RVM
2011-08-03 11:48:33 -04:00
2011-09-22 15:40:40 -04:00
If you don't have RVM yet, [Install RVM ](/docs/setup/rvm ) and then install Ruby 1.9.2.
2011-07-19 22:28:48 -04:00
2011-09-19 13:19:20 -04:00
```sh
2011-09-24 06:16:47 -04:00
rvm install 1.9.2 & & rvm use 1.9.2
2011-08-02 00:40:15 -04:00
```
2011-07-19 22:28:48 -04:00
2011-09-22 15:40:40 -04:00
### Using rbenv
2011-09-22 14:58:44 -04:00
2011-09-22 15:40:40 -04:00
If you don't have rbenv yet, [Install rbenv ](https://github.com/sstephenson/rbenv#section_2 ) and [install ruby-build ](https://github.com/sstephenson/ruby-build ), then install Ruby 1.9.2.
2011-09-22 14:58:44 -04:00
```sh
rbenv install 1.9.2-p290
```
2011-09-19 13:19:20 -04:00
## Setup Octopress
2011-07-19 22:28:48 -04:00
2011-09-19 13:19:20 -04:00
```sh
git clone git://github.com/imathis/octopress.git octopress
2011-09-22 14:58:44 -04:00
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.2
2011-08-02 00:40:15 -04:00
```
2011-09-22 14:58:44 -04:00
If `ruby --version` doesn't say you're using Ruby 1.9.2, you may want to [revisit your RVM installation ](/docs/setup/rvm ).
2011-09-19 13:19:20 -04:00
Next, install dependencies.
```sh
gem install bundler
2011-12-10 06:17:12 -05:00
rbenv rehash # If you use rbenv, rehash to be able to run the bundle command
2011-09-19 13:19:20 -04:00
bundle install
```
2011-07-19 22:28:48 -04:00
2011-09-19 13:19:20 -04:00
Install the default Octopress theme.
2011-07-19 22:28:48 -04:00
2011-08-02 00:40:15 -04:00
``` sh
2011-09-19 13:19:20 -04:00
rake install
2011-08-02 00:40:15 -04:00
```
2011-07-23 01:36:20 -04:00
2011-09-19 13:19:20 -04:00
## Next Steps
2011-07-23 01:36:20 -04:00
2011-09-19 13:19:20 -04:00
- [Set up deployment ](/docs/deploying )
- [Configure your blog ](/docs/configuring )
- [Start blogging with Octopress ](/docs/blogging )