{"id":389,"date":"2017-07-20T11:55:20","date_gmt":"2017-07-20T15:55:20","guid":{"rendered":"https:\/\/mberlove.com\/blog\/?p=389"},"modified":"2017-07-20T11:55:20","modified_gmt":"2017-07-20T15:55:20","slug":"hanami-ruby-on-ubuntu","status":"publish","type":"post","link":"https:\/\/mberlove.com\/blog\/hanami-ruby-on-ubuntu\/","title":{"rendered":"Hanami (Ruby) on Ubuntu"},"content":{"rendered":"
<\/figure>\n

Hanami is a modern Ruby web framework. I\u2019m experimenting with it right now.<\/p>\n

 <\/p>\n

Ubuntu, compared to other linux distros, or to a mac, can often require different steps when getting started with a new tool. Here is the process I followed, which got me up and running in just a few moments of work.<\/p>\n

 <\/p>\n

Install RVM<\/a>
\nRuby Version Manager (RVM) is one of the easiest ways to handle Ruby versioning, stay up to date, and minimize frustration.<\/p>\n

 <\/p>\n

If you already have RVM, run rvm get stable<\/code> to make sure you\u2019re up to date. Then run rvm cleanup all<\/code> to get rid of any cruff (not strictly necessary, just useful).<\/p>\n

 <\/p>\n

For Hanami, you\u2019ll need to be using a modern version of Ruby, 2.3.1 or higher.
\nYou can have RVM list the Ruby versions it\u2019s aware of by typing rvm list known<\/code>. From this list you can select the version you want and install that with rvm install<\/code>; at time of writing the newest stable Ruby version was 2.4.0, so I ran rvm install ruby-2.4.0<\/code>.
\nThis should also set your newly installed version of Ruby as the one that is selected to be used, but if you want to change it manually, you can run rvm use ruby-2.4.0<\/code>, etc.<\/p>\n

 <\/p>\n

Now we\u2019re ready for Hanami itself. Simply install the Hanami gem by running gem install hanami<\/code>.<\/p>\n

 <\/p>\n

You\u2019ll also need to make sure you have your database of choice installed (sqlite, postgres, etc).
\nFor my purposes, I ran sudo apt-get install sqlite-3 libsqlite-dev<\/code>. Chances are, on Ubuntu, you can skip this step, as it will already be installed.<\/p>\n

 <\/p>\n

Create a new project with hanami\u2019s new<\/code> command, e.g:
\nhanami new myproject<\/code><\/p>\n

The new<\/code> command will create a directory of the name you specified for the project; move into that directory (cd<\/code>, etc), and run a bundle install<\/code> to make sure everything\u2019s ready to go. This might take a few minutes.<\/p>\n

 <\/p>\n

You\u2019re now ready! Run bundle exec hanami server<\/code> to check out your new project being served at localhost:2300<\/code>.<\/p>\n

 <\/p>\n

You can use Hanami\u2019s getting started guide<\/a> as a launching pad, or check out the numerous guides and resources<\/a> for learning this framework.<\/p>\n

 <\/p>\n

Good luck, and have fun!<\/p>\n","protected":false},"excerpt":{"rendered":"

Hanami is a modern Ruby web framework. I\u2019m experimenting with it right now.   Ubuntu, compared to other linux distros, or to a mac, can often require different steps when getting started with a new tool. Here is the process […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[125,169,147,104],"tags":[212,72],"class_list":["post-389","post","type-post","status-publish","format-standard","hentry","category-programming","category-ruby","category-software-engineering","category-web-dev","tag-hanami","tag-ruby"],"_links":{"self":[{"href":"https:\/\/mberlove.com\/blog\/wp-json\/wp\/v2\/posts\/389","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mberlove.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mberlove.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/mberlove.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/mberlove.com\/blog\/wp-json\/wp\/v2\/comments?post=389"}],"version-history":[{"count":3,"href":"https:\/\/mberlove.com\/blog\/wp-json\/wp\/v2\/posts\/389\/revisions"}],"predecessor-version":[{"id":392,"href":"https:\/\/mberlove.com\/blog\/wp-json\/wp\/v2\/posts\/389\/revisions\/392"}],"wp:attachment":[{"href":"https:\/\/mberlove.com\/blog\/wp-json\/wp\/v2\/media?parent=389"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mberlove.com\/blog\/wp-json\/wp\/v2\/categories?post=389"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mberlove.com\/blog\/wp-json\/wp\/v2\/tags?post=389"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}