RubyTime is a web application for time tracking and invoicing, written in Ruby using Merb framework. It’s a complete rewrite of RubyTime 2.4 which was formerly a Ruby on Rails application.
RubyTime is no longer maintained.
RubyTime project is not maintained anymore. You can try to use it at your own risk, but don’t expect any support.
If you’re really determined to give it a try, the Rails 3 branch is probably the best point to start at. The master branch is based on Merb, which itself hasn’t been updated in a few years, so we started migrating the app to Rails 3.×. We didn’t finish the migration, but we were pretty close, so it should be possible to get it to run without too much work, though there might be still some bugs lurking in the code.
See CHANGELOG.txt.
You need to have Ruby version 1.8.7 and RubyGems 1.3.6+ installed on your server. You also need the Bundler gem (0.9+).
For now you also need git to install some of the gems in the Gemfile.
Next get the source code from RubyTime git repository (‘stable’ branch is recommended):
git clone git://github.com/LunarLogicPolska/rubytime.git -b stableInside the rubytime directory, install gems using Bundler:
bundle installNote: on 64 bit architectures, you may have to set ARCHFLAGS=‘-arch x86_64’ in your shell environment, otherwise some compiled gems (do_mysql) may not work.
- copy config/database.yml.example to config/database.yml, then edit it to match your database configuration
- copy config/local_config.rb.example to config/local_config.rb, then set application domain and mailer “From” address
- copy config/schedule.rb.example to config/schedule.rb and update it to set your reminder schedules
- copy config/ldap.yml.example to config/ldap.yml and set your LDAP address/port if you want LDAP authentication support
Create a development database (named rubytime3_dev by default). Then fill it with tables and data:
- run
bundle exec rake db:automigrateto create database structure (note: this destroys existing structure and data) - run
bundle exec rake rubytime:kickstartto populate database tables with initial data (admin account, example clients and projects)
Run the application:
bundle exec merbPoint your browser to url set in config/local/config.rb and login as admin with password password
Deployment is done using the Vlad library. Make a copy of config/deploy.rb.example in config/deploy.rb, and edit the server, username and directory values according to your setup. You can add or remove environments (staging and prodution are included by default). Deploy.rb assumes you use Passenger – you’ll have to customize it if you use something else.
On the server, create a production database (named rubytime3_prod by default). Then, back on your development machine, call Vlad to create directory structure on the server:
bundle exec rake production vlad:setupIf necessary, replace ‘production’ with ‘staging’ or whatever other environment you have configured in deploy.rb. Then, inside the “shared” directory created by Vlad in the project directory on the server, create a “config” directory, prepare copies of database.yml and local_config.rb configured for your server, and put them inside the shared/config directory.
Call Vlad again (from development machine) to deploy the code:
bundle exec rake production vlad:deploy_with_db_resetBack on the server, populate the database with initial data (call from project’s ‘current’ directory):
MERB_ENV=production bundle exec rake rubytime:kickstartYour server should be ready. If it’s not, try deploying once again:
bundle exec rake production vlad:deployFor future deployments, use bundle exec rake production vlad:deploy for normal deploys and bundle exec rake production vlad:deploy_with_autoupgrade if you need to change database schema.
There is an iPhone app for RubyTime, called iRubyTime, also available on GitHub. You can also download it from the AppStore. You need RubyTime 3.1.1 or later if you want to use iRubyTime.