User login

Installing Etherpad Light on Debian

It's actually called Etherpad Lite but i hate that spelling.

This will be a copy-paste of http://mclear.co.uk/2011/08/01/install-etherpad-lite-on-ubuntu/ except for a few things taken from https://github.com/Pita/etherpad-lite#readme and workarounds when things do not go as planned.

See what Debian you are starting out with with vi /etc/debian_version. We had 6.0.2.

The etherpad user was created with password etherpad, full name Etherpad Lite, everything else as defaults of the adduser script.

The make command took 4 minutes, 48 seconds for me.

apt-get install build-essential python libssl-dev git-core git libsqlite3-dev gzip curl
# you will be prompted to press Y
sudo adduser etherpad
su etherpad
mkdir ~/local
cd ~/local
wget http://nodejs.org/dist/node-v0.4.10.tar.gz
tar -zxvf node-v0.4.10.tar.gz
cd node-v0.4.10/
./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
curl http://npmjs.org/install.sh | sh
# You will be prompted to type yes
# No instructions said to change directory but it seems cleaner.
cd ../
git clone 'git://github.com/Pita/etherpad-lite.git'
etherpad-lite/bin/installDeps.sh
etherpad-lite/bin/run.sh

Will wonders never cease; it worked. Agaric now has its own etherpad.

Temporary Re-run Commands

The above instructions kill it as soon as you close the terminal window which is running the session. To restart, for some strange reason the source command has to be re-run.

su etherpad
source ~/.profile
~/etherpad-lite/bin/run.sh

It seems the proper way is to run it as a service, however.

Etherpad Light as a Service

Presumably the two chowns are overkill.

sudo mkdir /var/log/etherpad-lite
sudo chown etherpad /var/log/etherpad-lite
sudo chown -R etherpad /var/log/etherpad-lite
sudo vi /etc/init.d/etherpad-lite
sudo chmod 755 /etc/init.d/etherpad-lite

The contents of my /etc/init.d/etherpad-lite file are taken directly from the etherpad-lite wiki how to deploy as a service page but here's the first section with the changed variables— my changes start at PATH:

#!/bin/sh

### BEGIN INIT INFO
# Provides:          etherpad-lite
# Required-Start:    $local_fs $remote_fs $network $syslog
# Required-Stop:     $local_fs $remote_fs $network $syslog
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: starts etherpad lite
# Description:       starts etherpad lite using start-stop-daemon
### END INIT INFO

PATH="/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/opt/node/bin:/home/etherpad/local/node/bin"
LOGFILE="/var/log/etherpad-lite/etherpad-lite.log"
EPLITE_DIR="/home/etherpad/local/etherpad-lite"
EPLITE_BIN="bin/safeRun.sh"
USER="etherpad"
GROUP="etherpad"
DESC="Etherpad Lite"
NAME="etherpad-lite"

Now we can start Etherpad Light with this etc/init.d script that will be familiar to us from such services as Apache:

sudo /etc/init.d/etherpad-lite start

Restart Etherpad Lite

Lost connection with the EtherPad lite synchronization server. This may be due to a loss of network connectivity.

That helpful error message started recurring constantly, instant 99% of the time i attempted to edit any pad.

sudo /etc/init.d/etherpad-lite restart

That restart fixed it.

Follow-up

It seems to be open to the public on our test server.

Other basic follow-up which i haven't done:
* http://mclear.co.uk/2011/08/01/how-to-change-the-welcome-pad-text-on-etherpad-lite/
* https://github.com/Pita/etherpad-lite/wiki

Possibly see also:
* http://blog.nodejitsu.com/keep-a-nodejs-server-up-with-forever

Searched words: 
etherpad on debian see debian version restart etherpad lite

Comments

Thank you very much for

Thank you very much for posting this. I was missing the part where I was to add my etherpad lite path to the PATH variable and couldn't figure out why it was working ... I saw your post and now I'm running my own etherpad lite service. I'm stoked.

Reverse proxy on Apache2

Thanks lots for this comprehensive tutorial! I've managed to get Etherpad Light running on Debian 6 - the customized commands here are really helpful!

I have a query: I am trying to get reverse proxy running so that I need not access my ether pad light install on port 9001. To that end, I've created the following virtual host entry:

ServerName etherpad.myserver.net

        <Proxy *>
                Order deny,allow
                Allow from all
        </Proxy>

        ProxyPass / http://localhost:9001/
        ProxyPassReverse / http://localhost:9001/

ServerSignature Off

But going to etherpad.myserver.net does not bring up my ether pad light instance :( Any advice? Thank you!

Repo has moved

The Etherpad Lite repo is now at http://github.com/ether/etherpad-lite.git

Post new comment

The content of this field is kept private and will not be shown publicly.
  • You may post code using <code>...</code> (generic) or <?php ... ?> (highlighted PHP) tags.
  • You can use Markdown syntax to format and style the text. Also see Markdown Extra for tables, footnotes, and more.
  • Web page addresses and e-mail addresses turn into links automatically.
  • Allowed HTML tags: <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd> <img> <blockquote> <small> <h2> <h3> <h4> <h5> <h6> <sub> <sup> <p> <br> <strike> <table> <tr> <td> <thead> <th> <tbody> <tt> <output>
  • Lines and paragraphs break automatically.

More information about formatting options

By submitting this form, you accept the Mollom privacy policy.