Etherpad-lite

From ArchWiki
Jump to: navigation, search

Related articles

Etherpad-Lite or just Etherpad, is a collaborative, multi-user web-editor based on NodeJS with the ability to import/export various office file formats.

Installation

Install etherpad-liteAUR from the AUR.

Configuration

Database

For testing purposes, the default database backend for Etherpad is the file-based DirtyDB. With that, you can run and test Etherpad-Lite without any further configuration.

If you want to use MySQL, PostgreSQL or SQLite, you can adjust those settings in the settings.json file. Further, you can set a password for the administrator interface on http://localhost:9001/admin, change port and listening address, etc.

At least, don't forget to set a sessionkey, e.g. generate with pwgen and pwgen -y 10 1 and write it down to:

/usr/share/webapps/etherpad-lite/settings.json

"sessionKey" : "",

Your Etherpad installation can be extended with plugins listed at the administrator interface.

Address

the default IP is 0.0.0.0, change it to 127.0.0.1 as assumed later.

/usr/share/webapps/etherpad-lite/settings.json

  //IP and port which etherpad should bind at
  "ip": "127.0.0.1",
  "port" : 9001,

Starting

Enable the etherpad-lite.service unit. You can then access Etherpad-Lite on http://127.0.0.1:9001 or directly access a pad on http://127.0.0.1:9001/p/padname

Known issues

Crashes on some Pads

https://github.com/ether/etherpad-lite/issues/2516#issuecomment-79659984

Lighttpd (Solved)

Due to a bug in socket.io, using etherpad-lite with lighttpd as reverse proxy did not work (nginx and others are not affected). This is solved as of socket.io version 1.0. [1]

See also