Installation · 7 min read · Oct 13, 2025

Wie man Etherpad auf Ubuntu 20.04 installiert

Etherpad ist ein webbasiertes Echtzeit-Online-Editor, der es Autoren ermöglicht, gleichzeitig ein Textdokument zu bearbeiten und alle Änderungen in Echtzeit zu überwachen. Es ist Open Source, anpassbar und bietet die Möglichkeit, den Text jedes Autors in seiner eigenen Farbe anzuzeigen. Es bietet auch eine HTTP-API, die Sie in Ihre Anwendungen integrieren können, um Benutzer und Gruppen zu verwalten. Es bietet mehrere Plugins, die Ihnen helfen, E-Mail-Benachrichtigungen, Datei-Uploads und Videoanrufe in Etherpad zu integrieren. In diesem Tutorial zeigen wir Ihnen, wie Sie den webbasierten Etherpad-Editor auf einem Ubuntu 20.04-Server installieren.

Voraussetzungen

  • Ein Server, der Ubuntu 20.04 ausführt.
  • Ein gültiger Domainname, der auf Ihre Server-IP zeigt.
  • Ein Root-Passwort ist für den Server konfiguriert.

Erste Schritte

Bevor Sie beginnen, müssen Sie Ihre Systempakete auf die neueste Version aktualisieren. Sie können dies tun, indem Sie den folgenden Befehl ausführen:

apt-get update -y

Sobald alle Pakete aktualisiert sind, müssen Sie einige Abhängigkeiten in Ihrem System installieren. Sie können alle mit dem folgenden Befehl installieren:

apt-get install gnupg2 git unzip libssl-dev pkg-config gcc g++ make build-essential -y

Sobald alle Pakete installiert sind, können Sie mit dem nächsten Schritt fortfahren.

MariaDB-Datenbank installieren und konfigurieren

Etherpad verwendet MariaDB als Datenbank-Backend. Daher müssen Sie den MariaDB-Server in Ihrem System installieren. Sie können ihn mit dem folgenden Befehl installieren:

apt-get install mariadb-server -y

Nach der Installation von MariaDB melden Sie sich mit dem folgenden Befehl an der MariaDB-Shell an:

mysql

Nach der Anmeldung erstellen Sie eine Datenbank und einen Benutzer für Etherpad mit dem folgenden Befehl:

MariaDB [(none)]> create database etherpad;  
MariaDB [(none)]> grant all privileges on etherpad.* to etherpad@localhost identified by 'password';

Als Nächstes spülen Sie die Berechtigungen und verlassen die MariaDB mit dem folgenden Befehl:

MariaDB [(none)]> flush privileges;  
MariaDB [(none)]> exit;

An diesem Punkt ist Ihre Datenbank für Etherpad konfiguriert. Sie können nun mit dem nächsten Schritt fortfahren.

Node.js installieren

Etherpad basiert auf Node.js. Daher müssen Sie Node.js in Ihrem System installieren. Standardmäßig ist die neueste Version von Node.js im Ubuntu 20.04 Standard-Repository nicht verfügbar. Daher müssen Sie das Node.js-Repository zu Ihrem System hinzufügen. Sie können es mit dem folgenden Befehl hinzufügen:

curl -sL https://deb.nodesource.com/setup_14.x -o nodesource_setup.sh  
bash nodesource_setup.sh

Sobald das Repository hinzugefügt wurde, installieren Sie Node.js mit dem folgenden Befehl:

apt-get install nodejs -y

Nach der Installation von Node.js überprüfen Sie die installierte Version von Node.js mit dem folgenden Befehl:

node -v

Sie sollten die folgende Ausgabe erhalten:

v14.15.0

Sobald Sie fertig sind, können Sie mit dem nächsten Schritt fortfahren.

Etherpad installieren und konfigurieren

Bevor Sie Etherpad installieren, wird empfohlen, Etherpad als separaten Benutzer auszuführen. Sie können einen neuen Benutzer für Etherpad mit dem folgenden Befehl erstellen:

adduser --home /opt/etherpad --shell /bin/bash etherpad

Sie werden aufgefordert, ein Passwort festzulegen, wie unten gezeigt:

Adding user `etherpad' ...
Adding new group `etherpad' (1000) ...
Adding new user `etherpad' (1000) with group `etherpad' ...
Creating home directory `/opt/etherpad' ...
Copying files from `/etc/skel' ...
New password: 
Retype new password: 
passwd: password updated successfully
Changing the user information for etherpad
Enter the new value, or press ENTER for the default
    Full Name []: Hitesh       
    Room Number []: 1
    Work Phone []: 
    Home Phone []: 
    Other []: 
Is the information correct? [Y/n] Y

Als Nächstes geben Sie dem Etherpad-Heimverzeichnis mit dem folgenden Befehl die entsprechenden Berechtigungen:

install -d -m 755 -o etherpad -g etherpad /opt/etherpad

Als Nächstes wechseln Sie den Benutzer zu Etherpad und laden die neueste Version von Etherpad aus dem Git-Repository mit dem folgenden Befehl herunter:

su - etherpad  
git clone --branch master https://github.com/ether/etherpad-lite.git

Als Nächstes wechseln Sie in das heruntergeladene Verzeichnis und starten Etherpad mit dem folgenden Befehl:

cd etherpad-lite  
bin/run.sh

Dies installiert alle Abhängigkeiten und startet den Etherpad-Server. Sobald der Server erfolgreich gestartet wurde, sollten Sie die folgende Ausgabe erhalten:

[2020-11-11 06:46:44.783] [INFO] console - Ihre Etherpad-Version ist 1.8.6 (2c8769a)
[2020-11-11 06:46:44.958] [INFO] console - Sie können auf Ihre Etherpad-Instanz unter http://0.0.0.0:9001/ zugreifen.
[2020-11-11 06:46:44.958] [WARN] console - Admin-Benutzername und Passwort sind in settings.json nicht festgelegt. Um auf den Admin zuzugreifen, kommentieren Sie 'users' in settings.json aus und bearbeiten Sie es.
[2020-11-11 06:46:44.958] [WARN] console - Etherpad läuft im Entwicklungsmodus. Dieser Modus ist langsamer für Benutzer und weniger sicher als der Produktionsmodus. Sie sollten die NODE_ENV-Umgebungsvariable auf Produktion setzen, indem Sie verwenden: export NODE_ENV=production

Als Nächstes drücken Sie CTRL + C, um den Server zu stoppen. Als Nächstes müssen Sie die settings.json-Datei bearbeiten und Ihre Datenbank- und Admin-Einstellungen definieren:

nano settings.json

Entfernen Sie die folgenden Zeilen:

"dbType" : "dirty",
  "dbSettings" : {
                   "filename" : "var/dirty.db"
                 },

Ändern Sie die MySQL-Einstellungen wie unten gezeigt:

  "dbType" : "mysql",
  "dbSettings" : {
    "user":     "etherpad",
    "host":     "localhost",
    "port":     3306,
    "password": "password",
    "database": "etherpad",
    "charset":  "utf8mb4"
  },

Ändern Sie die Zeile trustProxy auf true:

  "trustProxy": true,

Definieren Sie ein Passwort für den Admin-Benutzer:

  "users": {
    "admin": {
      "password": "adminpassword",
      "is_admin": true
    },

Speichern und schließen Sie die Datei, und installieren Sie dann die erforderlichen Abhängigkeiten mit dem folgenden Befehl:

./bin/installDeps.sh

Sobald alle Abhängigkeiten installiert sind, verlassen Sie den Etherpad-Benutzer mit dem folgenden Befehl:

exit

An diesem Punkt ist Etherpad installiert und konfiguriert. Sie können nun mit dem nächsten Schritt fortfahren.

Erstellen Sie eine Systemd-Dienstdatei für Etherpad

Als Nächstes müssen Sie eine systemd-Dienstdatei erstellen, um den Etherpad-Dienst zu verwalten. Sie können sie mit dem folgenden Befehl erstellen:

nano /etc/systemd/system/etherpad.service

Fügen Sie die folgenden Zeilen hinzu:

[Unit]
Description=Etherpad-lite, der kollaborative Editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad/etherpad-lite
Environment=NODE_ENV=production

ExecStart=/usr/bin/node /opt/etherpad/etherpad-lite/src/node/server.js

Restart=always

[Install]
WantedBy=multi-user.target

Speichern und schließen Sie die Datei, und laden Sie dann den systemd-Daemon neu, indem Sie den folgenden Befehl ausführen:

systemctl daemon-reload

Als Nächstes starten Sie den Etherpad-Dienst und aktivieren ihn, damit er beim Systemneustart gestartet wird, mit dem folgenden Befehl:

systemctl start etherpad  
systemctl enable etherpad

Sie können auch den Status des Etherpad-Dienstes mit dem folgenden Befehl überprüfen:

systemctl status etherpad

Sie sollten die folgende Ausgabe sehen:

? etherpad.service - Etherpad-lite, der kollaborative Editor.
     Loaded: loaded (/etc/systemd/system/etherpad.service; disabled; vendor preset: enabled)
     Active: active (running) since Wed 2020-11-11 06:50:49 UTC; 4s ago
   Main PID: 12269 (node)
      Tasks: 13 (limit: 4691)
     Memory: 119.1M
     CGroup: /system.slice/etherpad.service
             ??12269 /usr/bin/node /opt/etherpad/etherpad-lite/src/node/server.js

Nginx für Etherpad konfigurieren

An diesem Punkt ist Etherpad gestartet und hört auf Port 9001. Als Nächstes müssen Sie Nginx installieren und konfigurieren, um als Reverse-Proxy auf Etherpad zuzugreifen. Zuerst installieren Sie Nginx mit dem folgenden Befehl:

apt-get install nginx -y

Als Nächstes erstellen Sie eine neue Nginx-virtuelle Host-Konfigurationsdatei mit dem folgenden Befehl:

nano /etc/nginx/sites-available/etherpad.conf

Fügen Sie die folgenden Zeilen hinzu:

upstream etherpad {
   server localhost:9001;
   keepalive 32;
}

server {
   listen 80;
   server_name etherpad.mydomain.com;

   location / {
       client_max_body_size 50M;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_http_version 1.1;
       proxy_pass http://etherpad;
   }
}

Speichern und schließen Sie die Datei, und aktivieren Sie dann die Nginx-virtuelle Host-Konfigurationsdatei mit dem folgenden Befehl:

ln -s /etc/nginx/sites-available/etherpad.conf /etc/nginx/sites-enabled/

Als Nächstes überprüfen Sie Nginx auf Syntaxfehler mit dem folgenden Befehl:

ginx -t

Sie sollten die folgende Ausgabe erhalten:

nginx: die Konfigurationsdatei /etc/nginx/nginx.conf Syntax ist ok
ginx: Konfigurationsdatei /etc/nginx/nginx.conf Test war erfolgreich

Als Nächstes starten Sie den Nginx-Dienst neu, um die Änderungen anzuwenden:

systemctl restart nginx

Sie können auch den Status von Nginx mit dem folgenden Befehl überprüfen:

systemctl status nginx

Sie sollten die folgende Ausgabe erhalten:

? nginx.service - Ein leistungsstarker Webserver und ein Reverse-Proxy-Server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2020-11-11 06:53:44 UTC; 6s ago
       Docs: man:nginx(8)
    Process: 12984 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 12985 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 13001 (nginx)
      Tasks: 3 (limit: 4691)
     Memory: 3.5M
     CGroup: /system.slice/nginx.service
             ??13001 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
             ??13002 nginx: worker process
             ??13003 nginx: worker process

Nov 11 06:53:44 ubuntu2004 systemd[1]: Starting Ein leistungsstarker Webserver und ein Reverse-Proxy-Server...
Nov 11 06:53:44 ubuntu2004 systemd[1]: Started Ein leistungsstarker Webserver und ein Reverse-Proxy-Server.

Etherpad aufrufen

Öffnen Sie jetzt Ihren Webbrowser und geben Sie die URL http://etherpad.mydomain.com ein. Sie werden auf die folgende Seite weitergeleitet:

Etherpad

Geben Sie Ihren Seitennamen ein und klicken Sie auf die Schaltfläche OK. Sie sollten Ihr Etherpad-Dashboard auf der folgenden Seite sehen:

Etherpad Online-Editor

Fazit

Herzlichen Glückwunsch! Sie haben Etherpad erfolgreich installiert und mit Nginx als Reverse-Proxy auf dem Ubuntu 20.04-Server konfiguriert. Sie können Etherpad nun problemlos in der Produktionsumgebung verwenden. Zögern Sie nicht, mich zu fragen, wenn Sie Fragen haben.

Share: X/Twitter LinkedIn
#Installation

Erhalte neue Beiträge in deinem Posteingang.

Kein Spam. Jederzeit abmelden.