Diese Anleitung ist eine erste Hilfestellung und vermutlich noch nicht vollständig.

Voraussetzungen

apt-get install nodejs nodejs-legacy npm

Installationsort: /var/www/etherpad

Systembenutzer einrichten

adduser --system --group --no-create-home --home /var/www/etherpad etherpad

Programm herunterladen und installieren

cd /var/www
wget https://github.com/ether/etherpad-lite/archive/1.6.1.zip
unzip 1.6.1.zip
rm 1.6.1.zip
ln -s etherpad-lite-1.6.1 etherpad
chown -R etherpad etherpad-lite-1.6.1

Datenbank vorbereiten

• die Datenbank soll „etherpad“ heißen
• der Datenbankbenutzer soll ebenfalls „etherpad“ heißen
• gutes kennwort für den Benutzer ausdenken. Das dieses lediglich in der Konfiguration eingetragen wird, spricht nichts gegen ein langes, komplexes Kennwort

mysql -u root -p
> CREATE DATABASE etherpad;
> CREATE USER 'etherpad'@'localhost' IDENTIFIED BY '********';
> GRANT CREATE,ALTER,SELECT,INSERT,UPDATE,DELETE ON etherpad.* TO 'etherpad'@'localhost';
> exit

Kennwort ändern im Fehlerfall

SET PASSWORD FOR 'etherpad'@'localhost' = PASSWORD('new-password-here');
FLUSH PRIVILEGES;

Konfiguration

cd etherpad
cp settings.json.template settings.json

settings.json

"dbType" : "mysql",
"dbSettings" : {   
    "user"    : "etherpad",
    "host"    : "localhost",
    "password": "********",
    "database": "etherpad",
    "charset" : "utf8mb4"
},
 
"loglevel": "WARN",
 
"users": {
  "admin": {
    "password": "****",
    "is_admin": true
  },
  "user": {
    "password": "****",
    "is_admin": false
  }
}, 

Optional: Proxy konfigurieren, falls Etherpad hinter einem Proxy eingerichtet wird

npm config set proxy http://"user:pass"@proxy.example.com:3128
npm config set https-proxy http://"user:pass"@proxy.example.com:3128

Starten

cd /var/www/etherpad
su etherpad -c bin/run.sh