Installing Loomio
I propose that the instructions on the Github wiki page for installing Loomio on a local machine specify the versions of Ruby and Rails on which Loomio is expected to run.
In the short term, hand-coding the recommended/supported version(s) of Ruby, Rails and even known good OS platforms into the install instructions would be helpful.
In the longer term, I (naively) wonder if there's a way for the Wiki page to pull the value(s) from the app Gemfile, or to have the value specified somewhere common to the Rails app and the wiki (i.e. keep it DRY)?
This is also important now as Ruby and Rails are both transitioning major versions. Perhaps a continuous build (Jenkins? Hudson!?) against various versions of Ruby and Rails would help keep developers informed of the status of the code, at least on major platform revisions?

Jon Lemmon Mon 15 Apr 2013 4:05AM
@rafaelgomes have you installed any Rails apps in the past on your computer? You'll need to make sure that you have all the dependencies installed. What OS are you on? Did you follow the guide?

Rafael Gomes Mon 15 Apr 2013 11:01AM
I am trying to install in Debian 6. I didn't follow this guide because I am not a devel guy, I just put a loomio to test here in Brazil.

Rafael Gomes Mon 15 Apr 2013 11:02AM
@jonlemmon Is there any guide to a non-devel guy?

Jon Lemmon Mon 15 Apr 2013 11:47AM
@rafaelgomes unforunately not at the moment. We definitely plan to make it easier to install Loomio in the future, but right now we have other more urgent priorities.
So realistically, you'll need to have a basic understanding of Rails before you'll be able to install Loomio. The best place to get started learning about Rails is probably here:

Rafael Gomes Mon 15 Apr 2013 10:46PM
hi @jonlemmon I asked to a friend help me with this.
My test server is working, but I got this error when tried login.
couldn't find file 'jqplot.1.0.0b2_r792'
(in /home/rafaelgomes/loomio/app/assets/stylesheets/application.css:6)
My test server : 194.14.56.232:3000

Rafael Gomes Mon 15 Apr 2013 11:15PM
I found this : http://search.4shared.com/postDownload/4B5Wey22/jqueryjqplot100b2_r792.html
But I don't know how install this :(

mix irving Mon 15 Apr 2013 11:49PM
if you look in the Gemfile, you can see:
gem 'jqplot-rails', '~> 0.1'
if you have run:
$ bundle install
this should have installed jqplot ... though i'm not sure how this would make sure we're using jqplot.1.0.0b2_r792
maybe the /application.css file needs changing
thoughts @jonlemmon ?
for reference, the official downloads are at :
https://bitbucket.org/cleonello/jqplot/downloads
the official page is : http://www.jqplot.com/
@rafaelgomes , I highly recommend the Rails Tutorial Jon recommended. It's not too complicated and everything is explained very clearly.

mix irving Mon 15 Apr 2013 11:51PM
sorry, that should read:
gem 'jqplot-rails', '~> 0.1'

Rafael Gomes Tue 16 Apr 2013 12:47AM
@johnirving I promise that I will learn rails, but these days I am very busy to start another thing :(
I did install manually jqplot-rails again, and don't works.
I did reported a bug : https://github.com/loomio/loomio/issues/656
I don't know if it is a bug or not. Sorry if I am doing it wrong.

Jon Lemmon Tue 16 Apr 2013 3:22AM
Hey @rafaelgomes, unfortunately we don't have the time/resources to help you get Loomio installed right now if you don't have basic Rails knowledge. However, once you've gone through the tutorial we've recommended and have a basic level of knowledge with Rails apps then we'll be happy to help you sort out any issues.
But for starters, I would recommend installing on Ubuntu. We don't really have any developers running Debian so it will be harder for us to support you if you're running on Debian.

Rafael Gomes Tue 16 Apr 2013 11:06AM
@jonlemmon ok, I will do that.
About jqplot.1.0.0b2_r792 in css file, it is correct version of this package or it is a error?
Sorry for bother you with these things. I hope help you in the future.

Jon Lemmon Tue 16 Apr 2013 11:56AM
@rafaelgomes No worries. =)
To be honest, I don't really know much about jqplot because I didn't install it in Loomio. I've never heard of anyone having to download it separately though, it should just work in Loomio straight-out-of-the-box.

Rafael Gomes Tue 16 Apr 2013 12:15PM
@jonlemmon may be the ubuntu already has this in its default installation.
I will find how install this in Debian. May be to help another guy, like me, to install in Debian too :)

Jon Lemmon Tue 16 Apr 2013 12:57PM
@rafaelgomes hmm, okay. I feel like the only file needed is already included in the github repo already though:
https://github.com/loomio/loomio/blob/master/app/assets/javascripts/lib/jqplot.pieRenderer.min.js
So I'm not really sure why you're getting that error. Hope your bug-hunting goes well! =)

Rafael Gomes Tue 16 Apr 2013 1:09PM
@jonlemmon I already had this file :(
rafaelgomes@suecia2:~$ file loomio/app/assets/javascripts/lib/jqplot.pieRenderer.min.js
loomio/app/assets/javascripts/lib/jqplot.pieRenderer.min.js: ASCII English text, with very long lines

Rafael Gomes Sun 21 Apr 2013 1:49AM
It is weird. I found the file, but the service don't :(
/var/lib/gems/1.9.1/gems/jqplot-rails-0.1/vendor/assets/javascripts/jqplot.1.0.0b2_r792.js
/var/lib/gems/1.9.1/gems/jqplot-rails-0.1/vendor/assets/stylesheets/jqplot.1.0.0b2_r792.css
According this, the package is installed, but may be stay in wrong place.

Rafael Gomes Sun 21 Apr 2013 2:27AM
Thanks for all return, I solved my problem:
wget https://bitbucket.org/cleonello/jqplot/downloads/jquery.jqplot.1.0.0b2_r792.tar.bz2
tar xvjf jquery.jqplot.1.0.0b2_r792.tar.bz2
cp ./dist/jquery.jqplot.js /home/rafaelgomes/loomio/app/assets/javascripts/jqplot.1.0.0b2_r792.js
cp ./dist/jquery.jqplot.css /home/rafaelgomes/loomio/app/assets/stylesheets/jqplot.1.0.0b2_r792.css
sudo foreman start
\o/

Rafael Gomes Sun 21 Apr 2013 4:58AM
After install without any error, I try to click in "Groups" link, and don't show me the menu. The same thing happens in my full name :(
Another thing, I don't have Notification link in my menu, is there any other version of this software?

mix irving Sun 21 Apr 2013 5:53AM
did you set up your first group as described in the 'installing on a local machine' guide?
I can't think of anything that would lead to you not being able to the notifications link. perhaps include a screenshot.
Richard D. Bartlett Sun 21 Apr 2013 11:02AM
You don't have any notifications yet, so the notifications link doesn't show up. It is a bit weird but that's how it works.

Rafael Gomes Sun 21 Apr 2013 3:39PM
Thanks @richarddbartlett for explanation about "Notifications", but why I can't edit my account configuration and see my Groups? it appear in Menu, but when I click I can't see my groups. :(
Take a look :
http://postimg.org/image/vgt7fygwv/
Richard D. Bartlett Sun 21 Apr 2013 8:39PM
@rafaelgomes have you followed these steps to create a group?

Rafael Gomes Mon 22 Apr 2013 1:33AM

Rafael Gomes Mon 22 Apr 2013 1:34AM
inside group
Richard D. Bartlett Mon 22 Apr 2013 2:26AM
Can you start discussions & decisions in the group?

Rafael Gomes Mon 22 Apr 2013 11:48AM
@richarddbartlett no problem with that :

Quentin Grimaud Tue 5 Aug 2014 4:29AM
I just succeeded installing loomio on my Ubuntu 14.04 (after having tried several times without success on my 12.04 => could not manage to install the required versions of ruby and rails). So here is a text file where I wrote each problem I had during installation, and how I fixed them. Hope this helps for improving the README file!

Alanna Irving Tue 5 Aug 2014 4:41AM
Wow that's great @quentingrimaud ! @robertguthrie @hannahsalmon check this out.

Robert Guthrie Tue 5 Aug 2014 6:01AM
Thanks @quentingrimaud! Awesome.
Note for whoever might iterate on this next: Would be cool to turn this into a list of 1 line error messages you can easily skim through to find a suggested course of action.
Deleted account Wed 6 Aug 2014 11:04PM
Thanks heaps @quentingrimaud! We'll definitely integrate that into our existing documentation!

FABRICE ALCINDOR Thu 8 Feb 2018 5:02PM
Hi, I try to install Loomio on Ubuntu 14.04 and I'l in trouble. I follow this tutorial: https://github.com/loomio/loomio/blob/master/docs/en/development_handbook/setup_environment.md
Install Node.js
You'll need Node.js and it's best if you use nvm to install it. From https://github.com/creationix/nvm You'll find that you need to run:
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.6/install.sh | bash
Now build and install node
I'm stuck at this instruction.
$ nvm install 8.4.0
$ nvm alias default 8.4.0
$ bundle install
$ npm install -g yarn gulp
$ cd client
$ yarn
Where can I find the "client" directory?
Thanks in advance
James Kiesel Thu 8 Feb 2018 10:51PM
@faf The /client directory is in the folder where you cloned loomio.
git clone https://github.com/loomio/loomio.git
cd loomio/client

FABRICE ALCINDOR Fri 9 Feb 2018 9:28AM
thx @gdpelican . That was my first guess, but it is not. Is it generated or shall it be there as soon as repo si cloned?
Here the commit checkout sha: ad825a07065a5bfaa1919edfe2b883058b4fd8a8
James Kiesel Fri 9 Feb 2018 9:34AM
That is a pretty old commit (Dec 29), and we've since moved the 'angular' folder into 'client'. Can you update to the latest repo?

FABRICE ALCINDOR Fri 9 Feb 2018 9:38AM
Seems much better. Thanks @gdpelican

FABRICE ALCINDOR Mon 12 Feb 2018 8:51AM
Hi,
I have finished the install procédure of the dev loomio on my VM Ubuntu 14.04. I start the server with the following command:
rails s
Server starts:
/home/alibivmuser/.rbenv/versions/2.4.3/lib/ruby/gems/2.4.0/gems/railties-5.1.4/lib/rails/app_loader.rb:40: warning: Insecure world writable dir /opt/alibi in PATH, mode 040777
=> Booting Puma
=> Rails 5.1.4 application starting in development
=> Runrails server -h
for more startup options
Warning: methodupdate
already defined
[29097] Puma starting in cluster mode...
[29097] * Version 3.11.0 (ruby 2.4.3-p205), codename: Love Song
[29097] * Min threads: 2, max threads: 8
[29097] * Environment: development
[29097] * Process workers: 2
[29097] * Preloading application
[29097] * Listening on tcp://0.0.0.0:3000
[29097] Use Ctrl-C to stop
[29097] - Worker 0 (pid: 29132) booted, phase: 0
[29097] - Worker 1 (pid: 29143) booted, phase: 0
I was first surprised by the listening adress prompted (see above 0.0.0.0) . I was expecting something like "localhost" of 127.0.0.1.
I found in an other thread that we shall then connect to http://127.0.0.1:3000
I did so but then I have the following
On server console
Started GET "/" for 127.0.0.1 at 2018-02-11 22:04:52 +0100
Processing by RootController#index as HTML
Redirected to http://localhost:3000/dashboard
Completed 302 Found in 227ms
Started GET "/dashboard" for 127.0.0.1 at 2018-02-11 22:04:52 +0100
Processing by ApplicationController#index as HTML
Rendering application/index.html.haml
Rendered angular/_metadata.html.haml (7.6ms)
Rendered application/_google_analytics.html.haml (1.6ms)
Rendered application/index.html.haml (513.5ms)
Completed 200 OK in 598ms (Views: 515.8ms | ActiveRecord: 8.4ms)
On my firefox console:
WARNING: content window passed to PrivateBrowsingUtils.isWindowPrivate. Use isContentWindowPrivate instead (but only for frame scripts).
pbu_isWindowPrivate@resource://gre/modules/PrivateBrowsingUtils.jsm:25:14
pbs<@resource://unity/observer.js:38:71
Observer.prototype.observe@resource://unity/observer.js:77:24
I first think it was due to my browser but it is the same with Google Chrome.
I'm a bit confuse while I can't point to any error to investigate what I might missed?
Any idea?
Thanks in advance,
Fabrice
Rafael Gomes · Mon 15 Apr 2013 2:57AM
I am try to install loomio on local machine, but I got that error
$ bundle exec rake db:schema:load
rake aborted!
uninitialized constant DiscussionsHelper::Twitter
/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/namespace.rb:191:in
eval'
'/home/rafaelgomes/loomio/app/helpers/discussions_helper.rb:1:in
/var/lib/gems/1.9.1/gems/actionpack-3.2.13/lib/abstract_controller/helpers.rb:135:in
block in modules_for_helpers'
map!'/var/lib/gems/1.9.1/gems/actionpack-3.2.13/lib/abstract_controller/helpers.rb:131:in
/var/lib/gems/1.9.1/gems/actionpack-3.2.13/lib/abstract_controller/helpers.rb:131:in
modules_for_helpers'
modules_for_helpers'/var/lib/gems/1.9.1/gems/actionpack-3.2.13/lib/action_controller/metal/helpers.rb:92:in
/var/lib/gems/1.9.1/gems/actionpack-3.2.13/lib/abstract_controller/helpers.rb:95:in
helper'
block (2 levels) in with'/var/lib/gems/1.9.1/gems/actionpack-3.2.13/lib/action_controller/railties/paths.rb:18:in
/home/rafaelgomes/loomio/app/controllers/application_controller.rb:1:in
<top (required)>'
module:InheritedResources'/var/lib/gems/1.9.1/gems/inherited_resources-1.3.0/app/controllers/inherited_resources/base.rb:11:in
/var/lib/gems/1.9.1/gems/inherited_resources-1.3.0/app/controllers/inherited_resources/base.rb:1:in
<top (required)>'
module:ActiveAdmin'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/base_controller/menu.rb:2:in
/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/base_controller/menu.rb:1:in
<top (required)>'
'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/base_controller.rb:2:in
/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/resource_controller/actions.rb:2:in
<module:ActiveAdmin>'
'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/resource_controller/actions.rb:1:in
/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/resource_controller.rb:2:in
<top (required)>'
module:Dashboards'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/dashboards/dashboard_controller.rb:3:in
/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/dashboards/dashboard_controller.rb:2:in
<module:ActiveAdmin>'
'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/dashboards/dashboard_controller.rb:1:in
(eval):1:in
generate_dashboard_controller'
eval'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/namespace.rb:191:in
/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/namespace.rb:191:in
generate_dashboard_controller'
initialize'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/namespace.rb:43:in
/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/application.rb:110:in
new'
find_or_create_namespace'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/application.rb:110:in
/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/application.rb:98:in
register'
register'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin.rb:74:in
/home/rafaelgomes/loomio/app/admin/woc_options.rb:1:in
<top (required)>'
block in load!'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/application.rb:161:in
/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/application.rb:161:in
each'
load!'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/application.rb:161:in
/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/application.rb:187:in
routes'
routes'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin.rb:78:in
/home/rafaelgomes/loomio/config/routes.rb:2:in
block in <top (required)>'
instance_exec'/var/lib/gems/1.9.1/gems/actionpack-3.2.13/lib/action_dispatch/routing/route_set.rb:289:in
/var/lib/gems/1.9.1/gems/actionpack-3.2.13/lib/action_dispatch/routing/route_set.rb:289:in
eval_block'
draw'/var/lib/gems/1.9.1/gems/actionpack-3.2.13/lib/action_dispatch/routing/route_set.rb:267:in
/home/rafaelgomes/loomio/config/routes.rb:1:in
<top (required)>'
block in load_paths'/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/application/routes_reloader.rb:40:in
/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/application/routes_reloader.rb:40:in
each'
load_paths'/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/application/routes_reloader.rb:40:in
/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/application/routes_reloader.rb:16:in
reload!'
reload_routes!'/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/application.rb:108:in
/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/reloader.rb:34:in
reload!'
block in attach!'/var/lib/gems/1.9.1/gems/activeadmin-0.4.3/lib/active_admin/reloader.rb:61:in
/var/lib/gems/1.9.1/gems/activesupport-3.2.13/lib/active_support/callbacks.rb:429:in
_run__2724464507161681211__prepare__4584786222408841597__callbacks'
__run_callback'/var/lib/gems/1.9.1/gems/activesupport-3.2.13/lib/active_support/callbacks.rb:405:in
/var/lib/gems/1.9.1/gems/activesupport-3.2.13/lib/active_support/callbacks.rb:385:in
_run_prepare_callbacks'
run_callbacks'/var/lib/gems/1.9.1/gems/activesupport-3.2.13/lib/active_support/callbacks.rb:81:in
/var/lib/gems/1.9.1/gems/actionpack-3.2.13/lib/action_dispatch/middleware/reloader.rb:74:in
prepare!'
prepare!'/var/lib/gems/1.9.1/gems/actionpack-3.2.13/lib/action_dispatch/middleware/reloader.rb:48:in
/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/application/finisher.rb:47:in
block in <module:Finisher>'
instance_exec'/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/initializable.rb:30:in
/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/initializable.rb:30:in
run'
block in run_initializers'/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/initializable.rb:55:in
/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/initializable.rb:54:in
each'
run_initializers'/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/initializable.rb:54:in
/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/application.rb:136:in
initialize!'
method_missing'/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/railtie/configurable.rb:30:in
/home/rafaelgomes/loomio/config/environment.rb:5:in
<top (required)>'
require_environment!'/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/application.rb:103:in
/var/lib/gems/1.9.1/gems/railties-3.2.13/lib/rails/application.rb:297:in
block (2 levels) in initialize_tasks'
call'/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:246:in
/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:246:in
block in execute'
each'/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:241:in
/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:241:in
execute'
block in invoke_with_call_chain'/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:184:in
/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:177:in
invoke_with_call_chain'
block in invoke_prerequisites'/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:205:in
/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:203:in
each'
invoke_prerequisites'/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:203:in
/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:183:in
block in invoke_with_call_chain'
invoke_with_call_chain'/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:177:in
/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/task.rb:170:in
invoke'
invoke_task'/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:143:in
/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:101:in
block (2 levels) in top_level'
each'/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:101:in
/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:101:in
block in top_level'
run_with_threads'/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:110:in
/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:95:in
top_level'
block in run'/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:73:in
/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:160:in
standard_exception_handling'
run'/var/lib/gems/1.9.1/gems/rake-10.0.4/lib/rake/application.rb:70:in
Tasks: TOP => db:schema:load => environment
(See full trace by running task with --trace)
How can I solve this?