Coda Hale has some extensive directions on this:
Basically, you need to install teh capistrano gem locally, make sure
that both localhost and external host have svn installed, create a
repository that is accessible by url and not file:/// and then go from
If you don't want to deply with a cluster, I'd follow the instructions
on the manual:
Sn in direct response to your questions:
No. Capistrano does the svn checkout. The process would be as follows.
This assumes that your local source code is already under version
control and you have a repository that is accessible from your
deployment host via svn:// or http://
1. Setup Capistrano locally (including deploy.rb)
2. Do an svn checkout to get the login/password cached by SVN on the
host. Delete this checkout.
3. Setup your database.yml file to match yoru deployment machine
4. svn commit -m "setting up for capistrano deployment"
You can then either cold_deploy or use setup to get the directory
At that point you should be able to cap deploy and get it working.
Again, Coda's directions are pretty good if youw ant to deploy wiht a
cluster, otherwise go for the rails manual.
Note: if you're looking to use 301 redirects on old URLs, and you are
deploying with a cluster, you can't place them in .htaccess. I wrote
an extensive article on it here: