• Installing Etherpad on Debian

    Date: 2010.03.10 | Category: debian, etherpad, google, guide, install, installations

    IMPORTANT NOTE: ETHERPAD HAS BEEN REPLACED BY ETHERPAD LITE. YOU SHOULD FOLLOW THIS GUIDE.

    IMPORTANT NOTE: THIS DOCUMENTATION IS NOW DATED.  You can now install Etherpad from apt.

    Installing Etherpad 1.0.1 with APT

    Add the following line as a source in your graphical package manager (In Ubuntu: System->Administration->Synaptic package manager; then Settings->Repositories and then finally Third party software), or edit the file /etc/apt/sources.list and add it there.

    deb http://apt.etherpad.org all .

    apt-get update
apt-get install etherpad

    Answer the questions (if any, depends on your system settings)

    /etc/init.d/etherpad start

    Other Linux distributions
    Download the .tgz and unpack it
    Follow instructions in README icon smile Installing Etherpad on Debian

    BELOW IS THE OLD GUIDE for Etherpad V1 released by Google

    Install prereqs
    
echo "deb http://ftp.de.debian.org/debian sid main non-free" >> /etc/apt/sources.list
apt-get update
apt-get install sun-java6-jdk

    If the above fails then do not continue.  The output of

    java -version

    Should read..

    java version "1.6.0_17"
Java(TM) SE Runtime Environment (build 1.6.0_17-b04)
Java HotSpot(TM) Client VM (build 14.3-b01, mixed mode, sharing)
    apt-get install scala mysql-server libmysql-java mercurial

    Paste the below to /etc/profile

    export PATH
export JAVA_HOME="/usr/lib/jvm/java-6-sun"
export SCALA_HOME="/usr/share/java"
export JAVA="/usr/bin/java"
export SCALA="/usr/bin/scala"
export PATH="/usr/bin:/usr/bin:/usr/local/mysql/bin:$PATH"
export MYSQL_CONNECTOR_JAR="/usr/share/java/mysql-connector-java-5.1.10.jar"
export JAVA_HOME SCALA_HOME JAVA SCALA MYSQL_CONNECTOR_JAR PATH
umask 022

    Download the etherpad source to /usr/local/etherpad

    hg clone https://etherpad.googlecode.com/hg/ /usr/local/etherpad

    Set the environment variables

    export JAVA_HOME="/usr/lib/jvm/java-6-sun"
export SCALA_HOME="/usr/share/java"
export JAVA="/usr/bin/java"
export SCALA="/usr/bin/scala"
export PATH="/usr/bin:/usr/bin:/usr/local/mysql/bin:$PATH"
export MYSQL_CONNECTOR_JAR="/usr/share/java/mysql-connector-java-5.1.10.jar"

    Add your domain to the superdomain section

    
nano /usr/local/etherpad/trunk/etherpad/src/etherpad/globals.js

    Search for etherpad.com and replace it with your domain (confused? You will figure it out)

    Create the etherpad mysql db and privelidges

    mysql -u root -p

    Enter your password when prompted

    create database etherpad;
grant all privileges on etherpad.* to 'etherpad'@'localhost' identified by 'password';
quit

    cd /usr/local/etherpad/trunk/etherpad/
ln -s /usr/share/java /usr/share/java/lib
bin/rebuildjar.sh
bin/run-local.sh

    Wait quite a while while it builds.

    Test by browsing to your server at http://hostnameofserver:9000

    Making pro work…

    Make sure it doesn’t redirect to etherpad.com for pro

    Edit /usr/local/etherpad/trunk/etherpad/src/main.js

    Replace all instances of Etherpad.com with yourdomain.com

    Edit /usr/local/etherpad/trunk/etherpad/src/static/crossdomain.xml

    Add to the obvious section

    
<allow-access-from domain="yourdomain.com" to-ports="*"/>

<allow-access-from domain="*.yourdomain.com" to-ports="*"/>

    Edit /usr/local/etherpad/trunk/etherpad/src/etherpad/pro/pro_utils.js

    Replace

    var fromDomain = 'etherpad.com';

    with

    var fromDomain = 'yourdomain.com';

    Note: Originally published on the 19th of Dec 2009, Revised on the 10th of March 2010