The Ruby Toolbox

As I was focusing on getting the new site ready for relaunch, development setup documentation got postponed. Pending #82, development documentation will be added here very soon! Thanks for your patience!

Prerequisites

Ruby-toolbox depends on a few external services which you will need to install before you begin.

Upgrading your system dependency manager

Linux with Yum-based package management:

[root@ip-1.3.3.7 ~]# yum update
Loaded plugins: priorities, update-motd, upgrade-helper
...
Complete!
[root@ip-1.3.3.7 ~]#

Linux with Apt-based package management:

admin@ip-1-3-3-7:~$ sudo apt-get update
Ign http://cloudfront.debian.net jessie InRelease
...
Fetched 15.3 MB in 3s (4,634 kB/s)
Reading package lists... Done
admin@ip-1.3.3.7:~$

OS-X with Homebrew:

(user@1.3.3.7 ~)$brew update
Updated 3 taps (homebrew/core, caskroom/versions, caskroom/cask).
==> New Formulae
...
==> Updated Formulae
...
(user@1.3.3.7 ~)

Installing Postgresql

Linux: Use the official package postgres repositories for

• Apt - see How to install and use postgreaql on ubuntu 16.04 for examples

• Yum - see How to install and use postgresql on CentOS 7 for exmaples

OS-X:

• HomeBrew - see How to install PostgreSQL on a Mac for examples

Installing REDIS

APT

If you want to use a prebuilt package, we recommend you use one from This PPA. Otherwise build from source as detailed in The REDIS quickstart

YUM etc

There is no easy mode for this, you will need to build it from source. See The REDIS quickstart

Ruby

Install the current project ruby version, preferably with a Ruby version manager like chruby, rbenv, or rvm

YARN

Yarn is used to manage javascript dependencies necessary to build the javascript assets for the project.

YARN can be installed by following the official installation guide

Configuring the ruby-toolbox application

1. Start Postgresql
2. Start REDIS
3. Install Bundler and gem dependencies

$ gem install bundler
$ bundle install

3. Create the database schema

$ rake db:setup
$ rake db:migrate

4. Install and configure YARN into the project

$ rake yarn:install

5. Start ruby-toolbox

   (user@1.3.3.7 ~/private/ruby/opensource/rubytoolbox)$puma -e development
   Puma starting in single mode...
   * Version 3.11.2 (ruby 2.5.0-p0), codename: Love Song
   * Min threads: 5, max threads: 5
   * Environment: development
   * Listening on tcp://0.0.0.0:3000