Twit-arr is a micro-blogging site that is set up for the JoCo Cruise
Ruby HTML CoffeeScript CSS Other
Clone or download
Latest commit 842df11 Feb 27, 2018
Failed to load latest commit information.
app MOAR failure to escape nonsense Feb 9, 2018
bin Updated to Rails 4.2. Resolves #228 Feb 15, 2015
config add routes for remote client GET and POST ops Jan 29, 2018
db fix event import Feb 3, 2018
lib The imagehelper library I wrote to help with animated photos. Dec 1, 2014
log Added the rest of the rails files... :( Aug 13, 2013
photo_storage Lets keep this directory to make the photo path more noticeable. Dec 1, 2014
public This is like pulling teeth Feb 24, 2017
test - First stab at ha… Dec 22, 2014
vendor/assets Events actually work now! Only thing that's really missing is event e… Jan 24, 2016
.dockerignore running twitarr on windows (in docker) Dec 19, 2015
.generators Fiddling Jun 30, 2014
.gitignore add production data seed Jan 18, 2016
.rakeTasks Model refactor to abstract redis Sep 8, 2013
.ruby-version Added .ruby-version file. Just for sake of development Feb 22, 2015
Dockerfile Upgrade to jruby 9 in Docker, make 'docker-compose build' work. Nov 13, 2017
Gemfile add retro paranoia gem for soft deletes Jan 24, 2018
Gemfile.lock add a db seed that imports/updates events Feb 16, 2016
LICENSE.txt Fixed #97 - added GPL Feb 1, 2014 Update Feb 27, 2018
Rakefile "rake test" now runs all tests Sep 27, 2013
color-palette.txt Improved styling Jan 4, 2015 Updated to Rails 4.2. Resolves #228 Feb 15, 2015
docker-compose.yml rename to Jan 9, 2016
multicast_server.rb Give the multicast client a few ms to start listening, seems safer/mo… Feb 27, 2015
multicast_test_client.rb Added first multicasting service discovery daemon and test client. De… Feb 27, 2015
perf_test.rb Search results is starting to look really good. Need to extend interf… Dec 27, 2014 change the funky author+mentions thing to be a boolean (include_author) Feb 7, 2016 rename to Jan 9, 2016

NOTE: I am not able to maintain this project any longer. Please feel free to fork and if there's community support for another repo then I'll link to it here


Twit-arr is a micro-blogging site that is set up for JoCo Cruise Crazy


Twit-arr was the name for the instance brought onto the cruise ship for JCCC2 and JCCC3. being less than optimal for this environment, I took it upon myself to build a new version, completely customized for the cruise. It does help that I wanted to have a chance to use Ember.js and Mongodb in production.

Docker setup

If you're not running on linux, or just want an isolated environment, you can run twitarr in docker.


You'll need the Docker toolbox. I (Joey) used version 1.16.1. The default install on a Mac is Just Fine; not sure about other platforms.


  • Create an application.yml and secrets.yml file based on the respective examples files. The tokens are just random hex strings (I think).
  • If you want to run with local changes (so that you can change the Ruby code and not have to rebuild the world each time), modify docker-compose accordingly:
  volumes:   # Remove this for production use
   - /Users/Joey/twitarr:/srv/app

Building the docker images


   $ docker-compose build
   $ docker-compose up

This will create a docker image based on JRuby 9, as well as download a MongoDB image.

This can take 10 minute to set up, as it generates indexes and seed data in mongo. Once it completes you should be able to reach twitarr via http://localhost:3000.

Quicker startup

After running the server once, it is no longer necessary to reseed the database. You can comment out the following lines in

#rake db:mongoid:create_indexes
#rake db:seed



You will need to make the config/application.yml and config/mongoid.yml files. There's already an example with some good defaults in config/*_example.yml, you just values for your instance. You can generate a rails secret token using the command "rake secret".

This was originally compatible in both MRI and JRuby - in theory it still is although it might require a little effort to get the image gems working in both. Anyone who wants to put in the effort is welcome to.

Quick Developer Setup


You require java version 1.6+ in order to use this.

Then you will need jruby installed. The easiest way to do this is to install it via RVM.

To install RVM run:

  $ \curl -sSL | bash -s stable

Then install jruby via RVM:

  $ rvm install jruby

Then in the future terminal sessions, you can use rvm use to set the terminal session enviorment to jruby:

  $ rvm use jruby

You will also need to download and run Mongodb

Since I like to keep my database just for this project, when I execute the mongod process I run:

 $ mkdir -p temp/data/db && mongod --dbpath temp/data/db

This will create the mongo database within this project's temp directory. The temp directory is also explictly ignored in the .gitignore file, so you don't have to worry about checking it in.

Project setup

First you will need to run:

  $ bundle install

Remember to set up your secrets file: (

Then you will need to setup mongo:

   $ cp config/mongoid-example.yml config/mongoid.yml

Now you have to tell mongoid to create the required indexes. If you forget to do this you will get strange errors that claims you must have indexes created in order to perform text searches.

  $ rake db:mongoid:create_indexes

Now you can seed the database with some initial data:

  $ rake db:seed

This will create 3 users. Each of the users' password is the same as their username.

  1. kvort (an admin user)
  2. james (a non-admin user)
  3. admin (another admin user)

Now we can finally run the rails server. By default this server can be hit from http://localhost:3000

  $ rails server