Template:Installation/Common: Difference between revisions

From diaspora* project wiki
(+ backup notice)
(Make updating Rubygems part of the default docs)
Line 25: Line 25:


It's time to install the Ruby libraries required by diaspora*:
It's time to install the Ruby libraries required by diaspora*:
{{Serious|1=Due to recent [http://blog.rubygems.org/2017/08/27/2.6.13-released.html security issues with RubyGems], run <tt>gem update --system 2.6.14</tt> before proceeding to the next steps. (15:27, 5 September 2017 (UTC))}}


{{#tag:syntaxhighlight|
{{#tag:syntaxhighlight|
gem update --system
gem install bundler
gem install bundler
script/configure_bundler
{{#ifeq:{{#var:gcc5}}|true|bin/bundle config --local build.sigar "--with-cppflags='-fgnu89-inline'"
{{#ifeq:{{#var:dist}}{{#var:version}}{{#varDB}}|CentOS6postgres|bin/bundle config --local build.pg '--with-pg-config=/usr/pgsql-<version>/bin/pg_config'
<nowiki/>|}}{{#ifeq:{{#var:dist}}{{#var:version}}{{#varDB}}|CentOS6postgres|bin/bundle config --local build.pg '--with-pg-config=/usr/pgsql-<version>/bin/pg_config'
<nowiki/>}}bin/bundle install --full-index
<nowiki/>}}{{#var:env_string}}bin/bundle install {{#ifeq:{{#var:mode}}|production| --jobs $(nproc) --deployment --without test development|}} --with {{#switch: {{#var:DB}}|mysql=mysql|postgres=postgresql|mariadb=mysql}}
|lang=bash}}
|lang=bash}}


This takes quite a while. When it's finished, you should see a message similar to: <tt>Bundle complete! 137 Gemfile dependencies, 259 gems now installed.</tt> If that's not the case, you should seek for help on the mailing list or the IRC channel.
This takes quite a while. When it's finished, you should see a message similar to: <tt>Bundle complete! 137 Gemfile dependencies, 259 gems now installed.</tt> If that's not the case, you should seek for help on the mailing list or the IRC channel. The <tt>--jobs $(nproc)</tt> flag speeds things a bit since it enables parallel downloading. <tt>nproc</tt> shows the number of CPU cores you have available.


Running the manual <tt>gem install</tt> command shown in the error message can sometimes show a clearer error message if the <tt>bundle</tt> command fails.
Running the manual <tt>gem install</tt> command shown in the error message can sometimes show a clearer error message if the <tt>bundle</tt> command fails.
Line 56: Line 55:


{{#ifeq: {{#var:mode}}|production|In the most simple case you want to do this inside a [http://www.gnu.org/software/screen/ screen] or [http://tmux.sourceforge.net/ tmux] session from which you can safely detach.|}}
{{#ifeq: {{#var:mode}}|production|In the most simple case you want to do this inside a [http://www.gnu.org/software/screen/ screen] or [http://tmux.sourceforge.net/ tmux] session from which you can safely detach.|}}
== Backup ==
{{Serious|1=You have to do backups of your pod data. If you lose your data, you won't be able to use the combination of your old username and old domain ever again. Make sure to store the backups on a different server, or at least on a different hard drive.<br />For details on how to do backups, see [[Pod data backup]].}}


== Further reading ==
== Further reading ==

Revision as of 09:30, 30 March 2018

Get the source

It's time to download diaspora*! As your diaspora user run:

cd ~
git clone  https://github.com/diaspora/diaspora.git
cd diaspora

Don't miss the cd diaspora, all coming commands expect to be run from that directory!

Configuration

Copy files

cp config/database.yml.example config/database.yml
cp config/diaspora.yml.example config/diaspora.yml


Bundle

It's time to install the Ruby libraries required by diaspora*:

gem update --system
gem install bundler
bin/bundle install  --with

This takes quite a while. When it's finished, you should see a message similar to: Bundle complete! 137 Gemfile dependencies, 259 gems now installed. If that's not the case, you should seek for help on the mailing list or the IRC channel. The --jobs $(nproc) flag speeds things a bit since it enables parallel downloading. nproc shows the number of CPU cores you have available.

Running the manual gem install command shown in the error message can sometimes show a clearer error message if the bundle command fails.

Database setup

Double check your config/database.yml looks right and run:

bin/rake db:create db:migrate

Start diaspora*

It's time to start diaspora*:

./script/server


Further reading