Difference between revisions of "Diaspora"

From ArchWiki
Jump to: navigation, search
(Adding basic instructions and some troubleshooting info)
(Prerequisites: added required libmysqlclient (gem mysql2 won't build without it))
(18 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[[Category:Networking (English)]]
+
[[Category:Networking]]
[[Category:HOWTOs (English)]]
+
{{i18n|Diaspora}}
+
 
+
 
[http://www.joindiaspora.com/ Diaspora] is the privacy aware, personally controlled, do-it-all, open source social network.
 
[http://www.joindiaspora.com/ Diaspora] is the privacy aware, personally controlled, do-it-all, open source social network.
 +
 +
On November 23, 2010 was [http://blog.joindiaspora.com/2010/11/23/private-alpha-released.html announced] that Diaspora is in [http://en.wikipedia.org/wiki/Software_release_life_cycle#Alpha private alpha] phase.
 +
 +
== Prerequisites ==
 +
* [https://aur.archlinux.org/packages.php?ID=43565 ruby-headers]
 +
* [https://wiki.archlinux.org/index.php/Java Java]
 +
* [https://www.archlinux.org/packages/extra/i686/libmysqlclient/ libmysqlclient]
 +
 +
 +
Install gems
 +
$ sudo gem install mysql2
 +
$ sudo gem install bundle
  
 
== Installation ==
 
== Installation ==
Since diaspora has not a stable version, you can install it with the [http://aur.archlinux.org/packages.php?ID=40859 development package] in [[AUR|Arch User Repository (AUR)]].
+
 
 +
=== Install Diaspora ===
 +
Since diaspora does not have a stable version, you can install it with the [https://aur.archlinux.org/packages.php?ID=40859 development package] in the [[AUR|Arch User Repository (AUR)]].
 +
 
 +
=== Diaspora Postinstallation ===
 +
create the configuration files and make changes according to your system needs
 +
$ cd /usr/share/webapps/diaspora
 +
$ cp config/application.yml.example config/application.yml
 +
$ cp config/database.yml.example config/database.yml
 +
$ cp config/script_server_config.yml.example config/script_server_config.yml
 +
 
 +
Use Bundler to install Diaspora application
 +
$ bundle install
 +
 
 +
=== Create Database ===
 +
Edit the Rakefile
 +
$ cd /usr/share/webapps/diaspora
 +
$ vi Rakefile
 +
 
 +
To fix the error "uninitialized constant Rake::DSL" add the line
 +
require 'rake/dsl_definition'
 +
right before
 +
require 'rake'
 +
 
 +
create the database and it's content using
 +
$ rake db:drop:all
 +
$ rake db:create
 +
$ rake db:migrate
 +
 
 +
=== Run Diaspora ===
  
 
*To run Diaspora:
 
*To run Diaspora:
Line 22: Line 60:
 
  $ sudo -u diaspora GEM_HOME=/opt/diaspora-gems rake db:seed:dev
 
  $ sudo -u diaspora GEM_HOME=/opt/diaspora-gems rake db:seed:dev
 
Then access http://localhost:3000/ and login with user 'tom' and password 'evankorth'.
 
Then access http://localhost:3000/ and login with user 'tom' and password 'evankorth'.
 
==Configuration==
 
Currently, there is no configuration file to edit diaspora ports, different servers, etc. Soon enough we will have one.
 
  
 
==Troubleshooting==
 
==Troubleshooting==
===Errors while navigating after an upgrade===
 
If you get an error after upgrading the package, the first thing you should do is delete the database you were using.
 
First, stop the diaspora daemon if it is running, and make sure mongodb is running:
 
$ sudo /etc/rc.d/mongodb start
 
Enter in the mongo console with:
 
$ mongo diaspora-development
 
Finally, drop the old database, it will be regenerated the next time you access diaspora:
 
> db.dropDatabase()
 
> exit
 
  
===GDM login screen with diaspora and/or mongodb users===
+
===GDM login screen with diaspora===
GDM will insert the users diaspora and mongodb in its login window because it currently considers the id range 500-1000 as normal users while Arch considers this range for system users as defined in /etc/login.defs. GDM does that probably to keep legacy normal users working.
+
GDM will insert the user diaspora in its login window because it currently considers the id range 500-1000 as normal users while Arch considers this range for system users as defined in /etc/login.defs. GDM does that probably to keep legacy normal users working.
To exclude these users from the login window, add this 'Exclude' line in your /etc/gdm/custom.conf file:
+
To exclude this user from the login window, add this 'Exclude' line in your /etc/gdm/custom.conf file:
 
  [greeter]
 
  [greeter]
  Exclude=mongodb, diaspora
+
  Exclude=diaspora
  
 
==More Resources==
 
==More Resources==
 
*[http://github.com/diaspora/diaspora Diaspora git]
 
*[http://github.com/diaspora/diaspora Diaspora git]

Revision as of 04:22, 29 August 2012

Diaspora is the privacy aware, personally controlled, do-it-all, open source social network.

On November 23, 2010 was announced that Diaspora is in private alpha phase.

Prerequisites


Install gems

$ sudo gem install mysql2
$ sudo gem install bundle

Installation

Install Diaspora

Since diaspora does not have a stable version, you can install it with the development package in the Arch User Repository (AUR).

Diaspora Postinstallation

create the configuration files and make changes according to your system needs

$ cd /usr/share/webapps/diaspora
$ cp config/application.yml.example config/application.yml
$ cp config/database.yml.example config/database.yml
$ cp config/script_server_config.yml.example config/script_server_config.yml

Use Bundler to install Diaspora application

$ bundle install

Create Database

Edit the Rakefile

$ cd /usr/share/webapps/diaspora
$ vi Rakefile

To fix the error "uninitialized constant Rake::DSL" add the line

require 'rake/dsl_definition'

right before

require 'rake'

create the database and it's content using

$ rake db:drop:all
$ rake db:create
$ rake db:migrate

Run Diaspora

  • To run Diaspora:
$ sudo /etc/rc.d/diaspora start

Then access http://localhost:3000/ to see the diaspora main page.

  • To stop Diaspora:
$ sudo /etc/rc.d/diaspora stop
  • (Optional) To start Diaspora automatically at boot, add the diaspora daemon in your /etc/rc.conf file:
DAEMONS=(... diaspora ...)
  • (Optional) To populate the database with sample users:
$ cd /opt/diaspora
$ sudo -u diaspora GEM_HOME=/opt/diaspora-gems rake db:seed:dev

Then access http://localhost:3000/ and login with user 'tom' and password 'evankorth'.

Troubleshooting

GDM login screen with diaspora

GDM will insert the user diaspora in its login window because it currently considers the id range 500-1000 as normal users while Arch considers this range for system users as defined in /etc/login.defs. GDM does that probably to keep legacy normal users working. To exclude this user from the login window, add this 'Exclude' line in your /etc/gdm/custom.conf file:

[greeter]
Exclude=diaspora

More Resources