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


or another JavaScript runtime


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 www.wagn.org/database_configuration.

Then run

cd mysite
wagn seed

..to 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 www.wagn.org/wagn_in_production.


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:

wagn update

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 wagn.org