- Ruby version 1.8.7* or 1.9.x
- Bundler version 1.0 or higher
- Either MySQL or PostgreSQL
* will no longer strongly support Ruby 1.8.7 after Wagn 2.0.
You will need: git, bundler, and either Postgres or Mysql.
- Get the source
Available in tar and zip files, but we recommend using git:
git clone git://github.com/wagn/wagn.gitTo checkout a different branch (eg. develop), try `git checkout -b develop origin/develop`
cd wagn # remaining commands should be executed from this directory
- Get libraries (ruby gems)
bundle install --without postgres:memcache:test:debug:development:assetsThe 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.
First,install needed config files with:
bundle exec rake wagn:install # production-only MySQL setupFor 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.
Seed your data
bundle exec rake wagn:create
- Start your server
To fire up the default, built-in WEBrick server, just run:
env STATIC_ASSETS=true bundle exec rails server
For installing earlier versions of Wagn, see installation: 1.7 and earlier.
Advanced Installation / Troubleshooting
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: ...If you're going to let unregistered users add/edit/comment on cards, we recommend that you use captcha.If you are hosting your own Wagn, you will need to register for ReCaptcha keys and put them in wagn.rb like so: ...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
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: