Dependencies

• Ruby  version 1.8.7 or higher
• Bundler version 1.0 or higher
• ImageMagick
• Either MySQL or PostgreSQL
• git

Installing Wagn

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

1. Get the source
   Available in tar and zip files, but we recommend using git:
   

   git clone git://github.com/wagn/wagn.git
   cd wagn # remaining commands should be executed from this directory

   To checkout a different branch (eg. develop), try `git checkout -b develop origin/develop`
2. Get libraries (ruby gems)
   

   bundle install --without postgres:memcache:test:debug:development:assets

   The above is for a mysql installation.  If you want to use postgres, switch "postgres" to "mysql" on the without list.
    
   Watch carefully for errors!  You may need to run as a admin user (using sudo, for example).  For more info see using bundler with Wagn.
3. Configure
   First,install needed config files with:

   bundle exec rake wagn:install # production-only MySQL setup

   For PostgreSQL setup, use `env ENGINE=postgres bundle exec rake wagn:install`
   For developer setup, use `env MODE=dev bundle exec rake wagn:install` 
   
   Then, edit the config/database.yml file as necessary.  The default configuration works if you have password-less root access to mysql.   More about database configuration.

4. Seed your data

   bundle exec rake wagn:create

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

   env STATIC_ASSETS=true bundle exec rails server

   ...and point your browser to http://localhost:3000 (unless otherwise configured).
   
   WEBrick is great for a quick test run.  To run a production website, see wagn in production.

For installing earlier versions of Wagn, see installation: 1.7 and earlier.

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    

You'll need to edit config/wagn.yml.  Here's a sample configuration:   smtp:   enable_starttls_auto: true   address: smtp.gmail.com   port: 587   domain: ...

Security Configuration    

If you're going to let unregistered users add/edit/comment on cards, we recommend that you use captcha.

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

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

...

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  

...

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)

...

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

...

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

...

ActionController::UnknownAction - No action responded to 0000    

+issue

+example

+screenshot

Status: +status

Tags: +tags

...

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.

...

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

...

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

...

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