fuzed
by Dave Fayram, Tom Preston-Werner
fuzed.rubyforge.org


== Summary
Leverage the YAWS webserver (and additional erlang-based infrastructure) to run Rails.


== Dependencies
* Erlang: http://www.erlang.org
* Yaws: http://yaws.hyber.org
* Ruby: http://www.ruby-lang.org
* Ruby Gems:
* rake: http://rake.rubyforge.org
* erlectricty: http://code.google.com/p/erlectricity
* rack: http://rack.rubyforge.org


== Installation (from gem)

gem install fuzed


== Installation (from git)

Get it from the git repo:

git clone git://repo.or.cz/fuzed.git

Change to the fuzed working copy:

cd fuzed

Build Fuzed:

rake build


== Configuration

Generate a starter Yaws config file with:

fuzed-conf RAILS_ROOT 8080

where RAILS_ROOT is the absolute path to the root directory of your Rails project. You may
optionally specify a port as the second argument. This will generate a file called
'fuzed.conf' which contains a sample Yaws config file that should be suitable for initial
testing.


== Starting fuzed

Start the fuzed master server (yaws) locally:

fuzed start -n [email protected] -c fuzed.conf

In another terminal, start a fuzed client locally:

fuzed join -n [email protected] -m [email protected] -r RAILS_ROOT

where RAILS_ROOT is the same as before.

Point your browser at:

http://localhost

If everything worked out, you'll see your Rails app!


== What is a Valid Hostname?
Erlang has a funny notion about what a valid hostname is. Localhost won't
cut it. I recommend using rendezvous to point to your local host. Short of
that, 127.0.0.1 works.


== Contribution Notes
* Please note that empty directories should contain a .placeholder file
(which should be empty), to facilitate the use of other version
control systems which bridge to subversion but don't support empty
directories.