Difference between revisions of "Diaspora"

From ArchWiki
Jump to: navigation, search
(Diaspora - The open source social networking tool.)
 
(Prerequisites: added required libmysqlclient (gem mysql2 won't build without it))
(20 intermediate revisions by 8 users not shown)
Line 1: Line 1:
This page will be the future home of a howto for Diaspora, the open source social networking tool. Since Diaspora was only launched on the 15th of September, please see [https://bbs.archlinux.org/viewtopic.php?pid=826763#p826763 this forum post], it will have the most up-to-date information.
+
[[Category:Networking]]
 +
[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 ==
 +
 
 +
=== 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:
 +
$ 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==
 +
*[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