Template:Installation/Introduction: Difference between revisions

From diaspora* project wiki
mNo edit summary
mNo edit summary
Line 1: Line 1:
== Introduction ==
== Introduction ==


{{Note|'''Running your own pod is not the only way to use Diaspora*.'''<br>See [http://podupti.me the list of community-operated servers] to join the network by registering an account on a public instance.}}
{{Note|'''Running your own pod is not the only way to use diaspora*.'''<br>See [http://podupti.me the list of community-operated servers] to join the network by registering an account on a public instance.}}


This guide will outline the procedure to get you set up with a {{#var:mode}}-ready installation of Diaspora*.
This guide will outline the procedure to get you set up with a {{#var:mode}}-ready installation of diaspora*.
{{#ifeq: {{#var:dist}}{{#var:version}}|DebianJessie|
{{#ifeq: {{#var:dist}}{{#var:version}}|DebianJessie|
{{Note|You may also use the [https://wiki.debian.org/Diaspora#Jessie diaspora-installer package], which is easier, but this method is not recommended yet.
{{Note|You may also use the [https://wiki.debian.org/Diaspora#Jessie diaspora-installer package], which is easier, but this method is not recommended yet.
Line 10: Line 10:


* '''The install is a bit complex, but we're here to help.''' <br>It's extremely helpful to have some experience in Linux/Unix server administration or Rails app deployment already. But don't worry, if you run into problems and need help, just visit us in [[How_We_Communicate#IRC|our IRC channels]] on Freenode.
* '''The install is a bit complex, but we're here to help.''' <br>It's extremely helpful to have some experience in Linux/Unix server administration or Rails app deployment already. But don't worry, if you run into problems and need help, just visit us in [[How_We_Communicate#IRC|our IRC channels]] on Freenode.
* '''Running a common setup will get you the most help, if you need it.'''<br>Most people in the community will have some experience running Diaspora* with [http://unicorn.bogomips.org/ Unicorn] as the app server using [http://nginx.org/ Nginx] as outward-facing web server. Of course, you're free to run any other app server (Thin, Passenger...) or web server (Apache), but you might find it harder to get help if you run into unexpected troubles.
* '''Running a common setup will get you the most help, if you need it.'''<br>Most people in the community will have some experience running diaspora* with [http://unicorn.bogomips.org/ Unicorn] as the app server using [http://nginx.org/ Nginx] as outward-facing web server. Of course, you're free to run any other app server (Thin, Passenger...) or web server (Apache), but you might find it harder to get help if you run into unexpected troubles.
* '''Diaspora* is developed utilizing latest web standards'''<br>Therefore UX is best with recent browsers, so please update your Firefox, Opera, Chrome or Safari to the newest version. We do not currently support any version of Internet Explorer, though we won't reject any [[Getting Started With Contributing|contributions attempting to change that]] circumstance.
* '''diaspora* is developed utilizing latest web standards'''<br>Therefore UX is best with recent browsers, so please update your Firefox, Opera, Chrome or Safari to the newest version. We do not currently support any version of Internet Explorer, though we won't reject any [[Getting Started With Contributing|contributions attempting to change that]] circumstance.
* '''Diaspora* strongly recommends HTTPS'''<br>as we encrypt communication amongst servers and to the client browsers. You can get a free TLS certificate from [https://letsencrypt.org Let's Encrypt], [http://www.wosign.com/english/freessl.htm WoSign] or [http://www.startssl.com/ StartSSL]. <br>''Unfortunately, self-signed certificates or certificates issued by CACert won't work.''
* '''diaspora* strongly recommends HTTPS'''<br>as we encrypt communication amongst servers and to the client browsers. You can get a free TLS certificate from [https://letsencrypt.org Let's Encrypt], [http://www.wosign.com/english/freessl.htm WoSign] or [http://www.startssl.com/ StartSSL]. <br>''Unfortunately, self-signed certificates or certificates issued by CACert won't work.''
* '''We need your feedback'''<br> to constantly improve and update this guide. Have a look at [[How we communicate]]
* '''We need your feedback'''<br> to constantly improve and update this guide. Have a look at [[How we communicate]]
* '''Do not run any of the commands you find in this guide as <tt>root</tt> (except if requested).'''<br>Just ''use your normal user'' - or even better - ''create a separate user'' for Diaspora* ([http://unix.stackexchange.com/a/29165 rationale]).
* '''Do not run any of the commands you find in this guide as <tt>root</tt> (except if requested).'''<br>Just ''use your normal user'' - or even better - ''create a separate user'' for diaspora* ([http://unix.stackexchange.com/a/29165 rationale]).

Revision as of 12:41, 2 September 2016

Introduction

NoteNote:Running your own pod is not the only way to use diaspora*.
See the list of community-operated servers to join the network by registering an account on a public instance.

This guide will outline the procedure to get you set up with a -ready installation of diaspora*.

Things to know

  • The install is a bit complex, but we're here to help.
    It's extremely helpful to have some experience in Linux/Unix server administration or Rails app deployment already. But don't worry, if you run into problems and need help, just visit us in our IRC channels on Freenode.
  • Running a common setup will get you the most help, if you need it.
    Most people in the community will have some experience running diaspora* with Unicorn as the app server using Nginx as outward-facing web server. Of course, you're free to run any other app server (Thin, Passenger...) or web server (Apache), but you might find it harder to get help if you run into unexpected troubles.
  • diaspora* is developed utilizing latest web standards
    Therefore UX is best with recent browsers, so please update your Firefox, Opera, Chrome or Safari to the newest version. We do not currently support any version of Internet Explorer, though we won't reject any contributions attempting to change that circumstance.
  • diaspora* strongly recommends HTTPS
    as we encrypt communication amongst servers and to the client browsers. You can get a free TLS certificate from Let's Encrypt, WoSign or StartSSL.
    Unfortunately, self-signed certificates or certificates issued by CACert won't work.
  • We need your feedback
    to constantly improve and update this guide. Have a look at How we communicate
  • Do not run any of the commands you find in this guide as root (except if requested).
    Just use your normal user - or even better - create a separate user for diaspora* (rationale).