Difference between revisions of "Diaspora"

From ArchWiki
Jump to: navigation, search
(Adding basic instructions and some troubleshooting info)
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. A full howto will be written once an install process is found that is environmentally agnostic.
+
[[Category:Networking (English)]]
 +
[[Category:HOWTOs (English)]]
 +
{{i18n|Diaspora}}
 +
 
 +
[http://www.joindiaspora.com/ Diaspora] is the privacy aware, personally controlled, do-it-all, open source social network.
 +
 
 +
== 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)]].
 +
 
 +
*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'.
 +
 
 +
==Configuration==
 +
Currently, there is no configuration file to edit diaspora ports, different servers, etc. Soon enough we will have one.
 +
 
 +
==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 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.
 +
To exclude these users from the login window, add this 'Exclude' line in your /etc/gdm/custom.conf file:
 +
[greeter]
 +
Exclude=mongodb, diaspora
 +
 
 +
==More Resources==
 +
*[http://github.com/diaspora/diaspora Diaspora git]

Revision as of 20:10, 16 October 2010

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

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

Installation

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

  • 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'.

Configuration

Currently, there is no configuration file to edit diaspora ports, different servers, etc. Soon enough we will have one.

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 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. To exclude these users from the login window, add this 'Exclude' line in your /etc/gdm/custom.conf file:

[greeter]
Exclude=mongodb, diaspora

More Resources