Skip to content
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:

  1. mysql
    mysql> create database webistrano
    Then create the database structure with Rake:
  1. cd webistrano
  2. RAILS_ENV=production rake db:migrate

4. Start Webistrano

  1. cd webistrano
  2. 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:

  1. sudo gem install mongrel
    Start:
  1. sudo gem install mongrel
  2. cd /webistrano/home/path
  3. mongrel_rails start -e production -d -p 3000
    Stop:
  1. cd /webistrano/home/path
  2. mongrel_rails stop
    Restart:
  1. cd /webistrano/home/path
  2. mongrel_rails restart
Clone this wiki locally