Revision as of 19:44, August 23, 2014 by Threesixes (Talk | contribs)


Source Repository:Gentoo Portage Tree

Summary: Centralized Ruby extension management system


Ruby is a programming language with its own package management system to extend the language.

Rubygems is a package management system to extend the ruby language.

Gems are packaged wonky in portage so this page will explain how to work with rubygems rather than fight it. Arch wiki outlines a similar method.

Emerge ruby & rubygems:

# emerge ruby rubygems

Remove conflicting gems:

# emerge -C dev-ruby/rake dev-ruby/racc dev-ruby/json dev-ruby/rdoc

Flush conflicting gems bad specs:

# mv /usr/local/lib64/ruby/gems/2.1.0/specifications/ /usr/local/lib64/ruby/gems/2.1.0/specifications.backup

Fetch gems via rubygems:

# gem install rdoc json rake racc
# rubygems-update

update gem system:

# update_rubygems
# gem update --system
# gem pristine --all

Now you're ready to use gem to manage gems.

To add gems to your path:

$HOME/.bashrc: add gem bin directory to your path
PATH="$(ruby -rubygems -e 'puts Gem.user_dir')/bin:$PATH"

ruby on rails

# gem install rails
# rails new testproject
# cd testproject
# bundle install


puma is a fast web server for ruby on rails.

To enable puma in your project:

$HOME/testproject/Gemfile: add puma gem to your rails application
gem 'puma'

To pull in puma:

# bundle install
$HOME/testproject/config/puma.rb: puma configuration file
workers Integer(ENV['PUMA_WORKERS'] || 3)
threads Integer(ENV['MIN_THREADS']  || 1), Integer(ENV['MAX_THREADS'] || 16)


rackup      DefaultRackup
port        ENV['PORT']     || 3000
environment ENV['RACK_ENV'] || 'development'

on_worker_boot do
  # worker specific setup
  ActiveSupport.on_load(:active_record) do
    config = ActiveRecord::Base.configurations[Rails.env] ||
    config['pool'] = ENV['MAX_THREADS'] || 16

to start puma:

# bundle exec puma

or if you added gems bin dir to your path

# puma