# Etherpad-lite

Related articles

- Gobby

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" : 19001,

## Starting

Enable the `etherpad-lite.service` unit. You can then access Etherpad-Lite on `http://127.0.0.1:19001` or directly access a pad on `http://127.0.0.1:19001/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

- Official Etherpad website
- Developement page on GitHub

Category:

- Internet applications