Skip to content

installation instructions

Schmidti edited this page Jan 6, 2011 · 8 revisions

Etherpad has not yet been packaged for neat installation.
Some instructions (testing April 6) that distil the ideas found below can be found
here: installation-instructions-II.


There is a brief guide here:

http://code.google.com/p/etherpad/wiki/Instructions

but a more comprehensive and thorough guide which covers installing on CentOS 5.3 is here:

http://pauleira.com/13/installing-etherpad/

and it references a bunch of other things:

More sources:

  • http://mclear.co.uk/2010/03/10/installing-etherpad-on-debian/
  • http://mclear.co.uk/2009/12/21/etherpad-ssl-https-pro-setup/
  • http://mclear.co.uk/2010/02/18/installing-etherpad-on-windows-cygwin/
  • http://bitbucket.org/gyokuro/etherpad-win/wiki/Home

Tips&tricks when installing on CentOS

While following this guide http://code.google.com/p/etherpad/wiki/Instructions on CentOS, also consider the following in the appropriate guide sections:

DNS

  • Put Etherpad on it’s own top level domain (example.org) instead of a subdomain (etherpad.example.org) otherwise you will get errors when it runs. Wildcard subdomains are then at *.example.org instead of *.etherpad.example.org.

Java

  • Download the Sun Java SDK self installing RPM version and install it
  • yum install jpackage-utils
  • Then add the jpackage repository
  • Then yum install mysql-connector-java. This will install openjdk and a lot of other packages, but that is OK.
  • (If you configure the jpackage repository before installing jpackage-utils, you get a missing dependency error later)

sslkeystore

  • The folder he suggests ( /appjet/data ) does not exist by default. It is created when you try to run the server. Either create it manually or run the server and let it fail then use the folder.