Sign up Sign in Samples Blog contact support
Installing Dependencies


*  version 1.8.7* - Wagn 1.13 is the last minor version to support ruby versions lower than 1.9.3.

To date, Wagn has been developed and maintained primarily on Unix-based systems, especially Mac OS X.  We will soon be improving this and adding strong Windows support.  In the meantime, our generous users have contributed these helpful instructions for installation on systems where they've encountered issues with our default installation process:

+On GNU Linux

Installing RubyVersionManager (RVM for short) and RUBY

Make sure you are logged in as your new 'your_user' (not root):


You'll need curl for this one, install it:

$ sudo apt-get install curl


Then type in:

$ \curl -sSL | bash -s stable --ruby


* if you get a signature error type in the command below and try again:

$ gpg --keyserver hkp:// --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3

** if you get a signature error again type this in and try again:

$ gpg --keyserver hkp:// --recv-keys D39DC0E3


* more info at


$ sudo apt-get install nodejs (needed when wagn update, complains about execjs)


Make sure bundler is the latest version


$ sudo gem install bundler 


Installing ImageMagick


$ sudo apt-get install imagemagick

$ sudo apt-get install libmagickwand-dev


Installing an RDBMS

* parts taken form



Install the package:

$ sudo apt-get install postgresql


Try to install the gem:

$ sudo apt-get install libpq-dev

$ sudo gem install pg


For more advanced options follow the guide on the Debian Wiki or the Arch Linux Wiki


Some actions require:

Becoming the 'postgres' user

(typically the "root" user for postgresql)


Several sections have instructions stating "become the postgres user". Commands that should be run as the postgres user are prefixed by [postgres]$ in this article.


To become the postgres user execute the following:

$ sudo -i -u postgres


If you like using root to get a shell as the postgres user:

$ su - postgres

The postgres user will automatically be created by installing PostgreSQL.


Now create the user and the database:

createuser -d wagn-user -P

(enter your database user password twice)

createdb -O wagn-user wagn-database

Postgres hints: you may have to mess with authentication config in pg_hba.conf to connect. Default configs have local identity based setting for authentication, and none for remote.


Example database.yml for Production

# MySQL.  Versions 4.1 and 5.0 are recommended.

# Be sure to use new-style password hashing:



  adapter: mysql2

  encoding: utf8

  reconnect: false

  database: test_development

  pool: 5

  username: root


  host: localhost


# Warning: The database defined as "test" will be erased and

# re-generated from your development database when you run "rake".

# Do not set this db to the same as development or production.

test: &test

  adapter: mysql2

  encoding: utf8

  reconnect: false

  database: test_test

  pool: 5

  username: root


  host: localhost


cucumber: *test



  adapter: postgresql

  encoding: utf8

  reconnect: false

  database: wagn-database

  pool: 5

  username: wagn-user

  password: 12345678

  host: localhost



Install the package:

# apt-get install mysql2   Try to install the gem $ gem install mysql2   If you're planning on using the mysql2 gem ...

+On Mac OS X
To be added.

To be added.