Octopress installation in Ubuntu 12.04 with rsync

Octopress is a blogging framework which generates your enire blog in static files. Octopress has integrated Twitter, Google Analytics, Google Plus, Facebook and some other webservices. There are also good plugins for adding images, code, videos and other content into your blog posts. The framework is made for hackers and people who know something about Linux and shell.

Requirements for this tutorial

  • Linux knowledge
  • Preconfigured webserver using Apache and home directories
  • Ubuntu 12.04 installation on your PC

This tutorial will be about the installation of blogging framework Octopress. As I have tested the installation process is not so simple for beginners as it is described in the official website.

There are three official ways to deploy Octopress

  • Github Pages
  • Heroku
  • Rsync

In this tutorial I will be focusing to basic installation of Octopress and the Rsync deployement.

Here are the installation steps:

Octopress installation

Ubuntu 12.04

Fresh Ubuntu installation will need the following packages to be installed.


We will be using RVM for controlling installation of Ruby and dependencies required by Octopress. Install RVM to your user profile with next command.

As we now have enabled Ruby environment on our system, we will need to install some packages to prepare it for Octopress.

Cloning Octopress from Github

Now it’s time to clone Octopress to our home directory.

After the clone is complete move to Octopress folder

You will get a notification from RVM asking do you trust new .rvmc file. Answer yes.

Installation of Octopress RVM Packages

Insert the following commands in Octopress folder to install it.

If you get the following error:

Solution to this is to update bundle version.

Congratulations! You have succesfully installed Octopress to your Ubuntu.

Rsync deployement

In order to publish your Octopress blog into your own webserver, you have to send the public files to the server. In this tutorial I assume you have setup the normal user account web publishing configurations.

Here are the steps how to use Rsync to publish your website:

Server modifications

We will start by creating an account to the server.

Login to your server and use sudo adduser command to add the user.

We also need to install rsync with the following command.

After this you can logout from your server.

Setting up public key authorization between Ubuntu and Server

First we create a public key with the following commands.

You will be asked where to save the key. Save the key to the default directory by pressing Enter.

Insert a passphrase for two times and the key will be created.

Now we need to send the public key to the server, specifically in your just created users’ home directory.
We can use ssh to send the file to your server.

Configuring rsync

Edit Rakefile in your octopress directory. Modify the following values.

Publishing the website

If the configurations are set, you can run the following commands and publish the website. Enter your Ubuntu password on prompt.

You should now get something like this at your public website.

Default installation of Octopress


Now you are ready to start blogging with Octopress.


Most important configurations can be found from the _config.yml. Just edit that and you can change all the default values like title and author to your own.

After changes just type the following commands and the site will be published.

Posting with Octopress

Create a new blog post with the following command. You need to be in the octopress directory to do this.

Then you may go and edit it in source/_posts/ directory.

Again after you have written your post and want to publish it to the website, use these commands.

Preview posts

If you want to preview your posts before publishing, use only the rake generate and see the changes yourself with the command rake preview and head on to web browser and type in localhost:4000.


The official Octopress Documentation is a good place to find more information about posting and using different kind of plugins and code blocks in your blog.

If you need more information about Octopress, be sure to check it out for answers!