Option A: Quick Start

recommended for new/trial sites

You will need: ruby (1.8.6+) and either Postgres or Mysql, and the appropriate ruby gems for your database.

1. Download the latest stable release from RubyForge
2. untar or unzip the package
3. install the dependencies

   bundle install --without test hosting sqlite postgres  #default command for mysql installs

   see using bundler with Wagn for more details / customization / troubleshooting
4. configure config/database.yml for your database. (defaults work with default mysql install)

5. rake wagn:create

6. ./script/server

Option B: Long Haul

recommended for active/production sites

We recommend installing via git for sites in active use in order to get access to the most recent code and to make upgrades easier.

You will need: git, bundler, and either Postgres or Mysql.

1. Get the source
   

   git clone git://github.com/wagn/wagn.git

2. Get the plugins

   cd wagn  # move to the wagn directory
   git submodule update --init

3. Get the gems
   
   using bundler with Wagn    

   1. Install bundler gem install bundler
   2. Use bundler to install / update your other gems. bundle install #WAIT! This is the basic

   ...
4. Configure your database

   cp config/sample_database.yml config/database.yml # copy sample config file

   Database Configuration    

   To configure your database, you will need to edit the config/database.yml file.   The defaults are set to use MySQL, but Wagn has been well ...

5. Generate your data

   rake wagn:create

6. Start your server
   To fire up the default, built-in WEBrick server, just run:
   

   ./script/server

   ...and point your browser to http://localhost:3000 (unless otherwise configured).
   
   See rails documentation to run your wagn on other servers.

Advanced Installation / Troubleshooting 

System Specific Installation Instructions    

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

Mail Configuration    

Mail server - if you don't have one on your machine, you can tell Wagn to use another mail server by adding something like this ...

Security Configuration    

If your wagn will be publicly accessible you should change the session_key and secret fields in config/database.yml   If you're going to let unregistered users ...

Captcha Configuration    

If you are hosting your own Wagn, you will need to  register for ReCaptcha keys and put them in wagn.rb like so: ...

Image Issues    

When all is working properly, Wagn stores several versions of an image: icon, small, medium, large, and full.  The preview you see upon uploading an ...

Special Urls and Ports    

Running on a different port or url Wagn by default assumes you'll be running it at http://localhost:3000 If this isn't the case, ...

Special Cardtypes    

Ruby and Script cards are both turned off by default, for security reasons. To turn them on, add the following ...

Installation Support / Questions and Answers

wagn 1.7 install fails for ruby-1.9.2 on OS X 10.6    

During bundle install --without hosting mysql on OS X 10.6.7 (Snow Leopard) using a dedicated RVM gemset the following error occurs: Installing rbx-require-relative (0.0.5)

...

snag with 1.6 installation    

I'm trying to get Wagn installed, and have hit a snag that I can't find any help on   I run  rake wagn:create   and

...

Installation not yet working on Rails 3    

Hello,   I'm stuck at step 4. (Installation B)   After rake gems:install --trace   i get this error:   (in /root/wagn) rake

...

Why is my WAGN so slow?    

I just installed WAGN for eval. Even though I am extremely intrigued by the possibilities and flexibility it offers, it just runs way too sluggish to

...

Editing cards shows HTML source code, not usable form fields    

Initial install doesn't work when trying to edit any cards. HTML tags appear as text without being rendered. ...   I hope you can forgive

...

ActionController::UnknownAction - No action responded to 0000    

I've got Wagn 1.5.2   When I upload an image named, for instance testimage.jpg, it gets correctly stored in <wagn_root>/card_images/0000/0009/testimage.jpg But when wagn try to

...

What gems do I need and what version should they be?    

+issue

+example

+screenshot

Status:

closed

Tags:

Installation

...

Installation on Windows    

I tried to install Wagn following both options described in Download Option A: Quick Start and Option B: Install via Git but any worked. I

...

TinyMCE broken in current Git version    

I just installed Wagn via Git, and editing cards is impossible - double-clicking a card leads to a display of the card source-code, not the

...

install breaks on `` exec syntax on windows.    

When I attempt the initial 'rake db:migrate' (with an empty MySQL database), everything builds up to (and including) the 'wiki_references' table. Immediately thereafter, rake aborts

...

add new Support ticket

also see older discussion items, related tickets

Wagneering - Online Configuration

Once your Wagn is installed and running, there are a number of configuration options which can be set up through the web interface, just follow the home page or sidebar links to "Config". You can read more here about configuration:

configuration    

Almost all Wagn configuration, or Wagneering is done by adding and editing cards.  Here are a few of the most important ...