Install Etherpad Lite on Ubuntu and Debian

UPDATE: These docs are now out of date, you should use the official install documents provided by the Etherpad Foundation.

Installing Etherpad Lite on Debian/Ubuntu clean.

Part 1 – Installing prerequisites

apt-get install build-essential python libssl-dev git-core git libsqlite3-dev gzip curl
# you will be prompted to press Y

Part 2 – Installing nodeJS and NPM

mkdir ~/local
cd ~/local
wget http://nodejs.org/dist/v0.6.12/node-v0.6.12.tar.gz
tar -zxvf node-v0.6.11.tar.gz
cd node-v0.6.11
./configure --prefix=$HOME/local/node
make
make install
echo 'export PATH=$HOME/local/node/bin:$PATH' >> ~/.profile
echo 'export NODE_PATH=$HOME/local/node:$HOME/local/node/lib/node_modules' >> ~/.profile
source ~/.profile

Part 3 – Installing Etherpad Lite and running it

git clone git://github.com/Pita/etherpad-lite.git
etherpad-lite/bin/run.sh
# You will be prompted to type Etherpad Lite rocks my socks.

You are now finished installing and Etherpad Lite should be running, you should be able to access it on http://localhost:9001

Only if you have an old version of Debian (Lenny) or Ubuntu then you will need to install sqllite from backports. To do open /etc/apt/sources.list and add:

deb http://backports.debian.org/debian-backports lenny-backports main

Save and close the file then type

apt-get update
apt-get -t lenny-backports install libsqlite3-dev

You may need to rebuild your modules if you have an error, to do this do an rm -Rf node_modules and run the startup script (run.sh) again!

Want to run Etherpad Lite as a service? Follow this guide. Make sure you do a chown -R etherpad-lite on the etherpad-lite folder if you have run it as root or any other user before hand..

Installing Etherpad on Debian

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 :)

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

Short throw projector rumour

I’m not usually one for spreading rumours but I heard today that you can get a Hitachi ultra short throw projector with wall mount fully fit for £949 with a full 3 year bulb + unit warranty.

I’m waiting on hearing confirmation but if this is true then it is an amazing deal! I guess we’re waiting on an official press release from the installs team..

Karting March 2009

Today is the end of year Karting day, we’re meeting at Bfd karting at 1pm.

Anyone who doesn’t know where it is just drop me a line.
Plan is:
  1. 1pm karting
  2. Pizza
  3. Pool
  4. Few drinks(non alcoholic)
  5. 4pm ish drive home
  6. Get changed
  7. 7pm go eat pepperpot near BD5 office.
  8. Few alcoholic drinks
  9. Gig at St G Hall
  10. Clubs
Phone will be on all day but I won’t be able to answer during karting so ring someone else from the team!