Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

the wiki on wheels: a Ruby on Rails app for building dynamic, structured websites out of wiki cards

This branch is 0 commits ahead and 0 commits behind develop

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 app
Octocat-spinner-32 bin
Octocat-spinner-32 config
Octocat-spinner-32 db
Octocat-spinner-32 features
Octocat-spinner-32 lib
Octocat-spinner-32 mods
Octocat-spinner-32 public
Octocat-spinner-32 script
Octocat-spinner-32 spec
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .rspec
Octocat-spinner-32 .simplecov
Octocat-spinner-32 CONTRIBUTING.rdoc
Octocat-spinner-32 GPL
Octocat-spinner-32 Gemfile
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 Rakefile
Octocat-spinner-32 VERSION
Octocat-spinner-32 wagn.gemspec

Wagn: how pioneers roll


Wagn is an open web platform for building coherent web systems.

Using simple wiki-inspired building blocks called cards, “Wagneers” construct sites ranging from simple content managers to custom project trackers to fully integrated web suites.

System Requirements


version 1.8.7 or higher


version 1.0 or higher


A database engine

Either MySQL or PostgreSQL


1. install the gem

gem install wagn

Watch carefully for errors!

2. create a new wagn application

wagn new mysite

3. create / seed database

Edit the config/database.yml file as necessary. More about database configuration at

Then run

cd mysite
rake wagn:create create and seed the database

4. start your server

To fire up the default, built-in WEBrick server, just run:

wagn server

…and point your browser to localhost:3000 (unless otherwise configured).

WEBrick is great for a quick test run. To run a production website, see


Standard Upgrades

1. Backups

Always back up your database and uploaded files.

2. Update Libraries

From your wagn root directory run:

bundle update

3. Update Database

Run the following:

rake wagn:migrate

As with all rake commands, you can try prefacing with “bundle exec” if you encounter gem problems.

4. Restart your server.

Upgrading pre-gem Wagn sites

First check the Wagn version of your existing site.

Version 1.10 or newer

  1. Create a new Wagn app using steps 1 and 2 from the installation section above.

  2. Copy config/database.yml from the old site to the new one.

  3. Copy the old local/files contents to the new files directory.

  4. If you have edited wagn.yml in your old site, make the corresponding changes to the new config/application.rb file.

  5. Follow the standard upgrade procedure above.

Older than Version 1.10

First update your Wagn to version 1.10 via the old update mechanisms, and then follow the directions above.

More Resources

Find lots more info at

Something went wrong with that request. Please try again.