Capistrano Series - Introduction

Welcome to the 'new and improved' Capistrano mini-series. We have updated these articles to work with Ubuntu Hardy, git (instead of subversion) and using the latest version of Capistrano (at the time of writing).

This first article will flesh out the aim of the series and explain what the end goal is.

Please don't skip this article as it will contain some important information...

Size does matter

If you are new to the command line and are not sure what to do or how to start then this is the place to be!

However, don't be put off by the number of articles that will be here (I will also point you to some existing articles along the way - just to add to the mix).

One thing I always try and do, and sometimes succeed, is to explain what I am doing and what the effect of a change will be.

Don't be put off as size does matter (in this case). Take it one section and one paragraph at a time. Skipping the really boring bits will more than likely cause the setup to burp and die in a horrible mess.


Actually, very few assumptions are made in this mini-series.

Sure, I'll point you to some existing articles so we are all on a level playing field for when we get to the meat of the series (the Capistrano bit) but you should be able to follow along with a brand new Slice right to the end without difficulty.

End Goal

So what's the point of this mini series?

Put simply, the aim is to get you from a brand new Slice to a fully working Ruby on Rails stack with Capistrano control.

As mentioned, some of the articles are already in existence. However, adding complementary articles and new articles and linking them together in a set order will help in setting up your Slice.

We'll go through:

  • Base setup of an Ubuntu Hardy Slice

  • Installing Ruby on Rails (we'll use sqlite3 for the DB in these examples)

  • Installing Git and setting up a repo with SSH access

  • Creating a Ruby on Rails application

  • Installing Apache with passenger (mod_rails) support

  • Creating a vhost for the Rails application

  • Install and configure Capistrano

  • Check out the repository and deploy using Capistrano

  • Add our first controller to the app, commit it and deploy via Capistrano


Quite a lot going to happen here.

However, taking it one step at a time will ensure we know what we are doing, why we are doing it and what happens when we do it.

I strongly recommend doing it the 'long' way (i.e. follow the articles) before using an automated installation tool (such as deprec) so you understand the concepts.

Once you are happy with the basics, the something like deprec is an excellent tool and if something goes wrong or you need to tweak it, you will know why and how.

The next article introduces Capistrano 2 and explains what it is and what it does.

Ben B.

Article Comments:

Heinrich Klobuczek commented Fri May 08 04:08:48 UTC 2009:

Some links missing here. Where are the articles?

PickledOnion commented Fri May 08 12:05:36 UTC 2009:

They are in the process of being written. We publish one article at a time.

When each article is published we update any links from the previous article.


gman commented Sat Aug 08 21:35:18 UTC 2009:

hi, i got as far as setting up the git user on the remote server in your series here and then can't find the rest i.e. setting up Capistrano and Github (please ;) ... am i missing the links to follow this series through to conclusion? i love these articles and have learned so much from them - i want my slice working EXACTLY how you recommend basically (call me unimaginative but you guys are the server masters at the end of the day, i just want to write web apps!!)

Want to comment?

(not made public)


(use plain text or Markdown syntax)