jweiss edited this page Sep 13, 2010 · 2 revisions

1. Preparation

Webistrano itself is a Ruby on Rails application that includes an edge version of Rails and all needed dependencies like Capistrano or Net::SSH. The only required dependencies are Ruby >= 1.8.4, Rake, and a SQL database.

2. Configuration

Copy config/webistrano_config.rb.sample to config/webistrano_config.rb and edit appropriatly.
In this configuration file you can set the mail settings of Webistrano.

3. Database

Copy config/database.yml.sample to config/database.yml and edit to resemble your setting.
You need at least the production database. The others are optional entries for development and testing.

Create a {MySQL|PostgreSQL|SQLite} database, e.g. for MySQL:

# mysql
bc. mysql> create database webistrano

Then create the database structure with Rake:

# cd webistrano
bc. # RAILS_ENV=production rake db:migrate

4. Start Webistrano

# cd webistrano
bc. # ruby script/server -d -p 3000 -e production

Webistrano is then available at http://host:3000/ The default user is admin, the password is admin.
Please change the password after the first login.

If you started Webistrano with the script/server command you can just send it a KILL signal to stop it.

5. Controlling Webistrano with Mongrel

A much nicer way of controlling Webistrano is using Mongrel:

Install Mongrel:

# sudo gem install mongrel


# sudo gem install mongrel
bc. # cd /webistrano/home/path
bc. # mongrel_rails start -e production -d -p 3000


# cd /webistrano/home/path
bc. # mongrel_rails stop


# cd /webistrano/home/path
bc. # mongrel_rails restart