Difference between revisions of "Template:Installation/Common"

From diaspora* project wiki
Jump to: navigation, search
(Creation of the db-Tables with the given command; https://stackoverflow.com/questions/25611004/rake-dbcreate-throws-database-does-not-exist-error-with-postgresql this could be the cause, with this command rake runs flawlessly)
(Tags: mobile edit, mobile web edit)
m (Backup)
Line 62: Line 62:
 
== Backup ==
 
== 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]].}}
 
{{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]].}}
 +
 +
If you have done your backup with the backup script[https://wiki.diasporafoundation.org/Pod_data_backup] you can restore your database as follows.
 +
Remember as described in the installation tutorial you have to create the database user <tt>diaspora</tt> before you restore the backup. Do '''NOT''' execute the comand <tt>RAILS_ENV=production bundle exec rake db:create db:migrate</tt>.
 +
 +
 +
Switch to your Diaspora system user
 +
 +
sudo -iu diaspora
 +
 +
Create a new empty database
 +
 +
createdb -T template0 diaspora_production -U diaspora
 +
 +
Restore your database backup
 +
 +
psql diaspora_production < backup.sql
  
 
== Further reading ==
 
== Further reading ==

Revision as of 09:19, 24 November 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 install bundler
script/configure_bundler
bin/bundle install --full-index

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.

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:

bundle exec rake db:create db:migrate


Start diaspora*

It's time to start diaspora*:

./script/server


Your diaspora server is now running, either on a unix socket (current default) or on http port 3000. The listening method can be configured in diaspora.yml, search for '3000' or 'listen' to find the correct line.

You will likely need to install a reverse proxy (example on github for apache2) in order to get it to be served publicly. If you are new to running rails applications you may find the diaspora components page helpful for orientation.

Backup

»» Important
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.
For details on how to do backups, see Pod data backup.


If you have done your backup with the backup script[1] you can restore your database as follows. Remember as described in the installation tutorial you have to create the database user diaspora before you restore the backup. Do NOT execute the comand RAILS_ENV=production bundle exec rake db:create db:migrate.


Switch to your Diaspora system user

sudo -iu diaspora

Create a new empty database

createdb -T template0 diaspora_production -U diaspora

Restore your database backup

psql diaspora_production < backup.sql

Further reading