Installation · 10 min read · Nov 02, 2025

Wie man Etherpad auf AlmaLinux 9 installiert

Etherpad ist eine kostenlose und Open-Source-Alternative zu Diensten wie Google Docs und Zoho Writer. Etherpad ist ein kollaborativer und Echtzeit-Texteditor für Ihr Team, der von überall und jederzeit zugänglich ist, da Etherpad ein webbasierter Texteditor ist.

Änderungen in Etherpad erfolgen in Echtzeit, und Etherpad unterstützt auch Versionierung und integrierte Formatierung für Teams. Etherpad ist ein hochgradig anpassbarer Editor mit Unterstützung für verschiedene Plugins. Es unterstützt auch moderne Dokumentformate wie doc, pdf, odt, markdown usw.

Dieses Tutorial zeigt Ihnen, wie Sie Etherpad auf einem AlmaLinux 9-Server mit einem MariaDB-Datenbankserver und einem Nginx-Webserver installieren. Sie werden Etherpad auch über SSL-Zertifikate sichern, um einen sicheren Zugriff zu ermöglichen.

Voraussetzungen

Um dieses Tutorial abzuschließen, stellen Sie sicher, dass Sie Folgendes haben:

  • Einen AlmaLinux 9-Server - Diese Demo verwendet ein AlmaLinux mit dem Hostnamen almalinux9.
  • Einen Nicht-Root-Benutzer mit Sudo-Rechten.
  • Einen Domainnamen, der auf die Server-IP-Adresse verweist.
  • Generierte SSL-Zertifikate über Letsecnrypt und Certbot.

Abhängigkeiten installieren

Bevor Sie Etherpad installieren, müssen Sie einige der Abhängigkeiten installieren, die von Etherpad benötigt werden, einschließlich:

  • Entwicklungstools
  • Node.js und NPM (Node Package Manager)
  • MariaDB-Datenbankserver
  • Nginx-Webserver

Führen Sie diese Schritte aus, um die Etherpad-Abhängigkeiten zu installieren.

Entwicklungstools installieren

Zuerst müssen Sie “Entwicklungstools“ auf Ihrem AlmaLinux-Server installieren. Geben Sie den folgenden dnf-Befehl ein, um “Entwicklungstools“ zu installieren, geben Sie y ein und drücken Sie ENTER, um fortzufahren.

sudo dnf group install "Development Tools"

Führen Sie als Nächstes den folgenden Befehl aus, um einige zusätzliche Abhängigkeiten zu installieren. Wenn Sie dazu aufgefordert werden, geben Sie y ein, um zu bestätigen, und drücken Sie ENTER.

sudo dnf install gzip git curl python3-devel openssl-devel pkg-config

install dependencies

Node.js und NPM installieren

Etherpad ist ein webbasierter Kollaborations- und Echtzeit-Editor, der hauptsächlich mit Node.js geschrieben wurde. Um es zu installieren, müssen Sie die Node.js-JavaScript-Laufzeit und NPM (Node Package Manager) installieren.

Zum Zeitpunkt des Schreibens benötigte Etherpad mindestens Node.js v16, das standardmäßig im AlmaLinux-Appstream-Repository verfügbar ist und Sie können es über DNF installieren.

Führen Sie den folgenden dnf-Befehl aus, um Node.js und NPM zu installieren. Geben Sie y ein, um die Installation zu bestätigen, und drücken Sie ENTER.

sudo dnf install nodejs npm

Sobald Node.js installiert ist, führen Sie den folgenden Befehl aus, um das /usr/local/bin-Verzeichnis zur PATH-Umgebungsvariable hinzuzufügen. Dies stellt sicher, dass einige Binärdateien, die über NPM installiert wurden, auf dem Server ausgeführt werden können.

echo "export PATH=$PATH:/usr/local/bin" >> ~/.bashrc  
source ~/.bashrc

Führen Sie als Nächstes den folgenden Befehl aus, um beide Binärdateien von Node.js und NPM zu finden.

which node  
which npm

Überprüfen Sie dann die Version von Node.js und NPM mit dem folgenden Befehl.

node --version  
npm --version

Die angezeigte Ausgabe bestätigt, dass Node.js v16 und NPM 8.x installiert sind und beide Binärdateien im /bin-Verzeichnis liegen.

checking node.js and npm

MariaDB-Server installieren

Standardmäßig verwendet die installierte Etherpad SQLite als Datenbank. Sie können MariaDB/MySQL als Datenbank für große Bereitstellungen Ihrer Etherpad-Installation verwenden.

Führen Sie den folgenden dnf-Befehl aus, um den MariaDB-Server zu installieren. Wenn Sie dazu aufgefordert werden, geben Sie y ein, um zu bestätigen, und drücken Sie ENTER.

sudo dnf install mariadb-server

install mariadb

Sobald MariaDB installiert ist, führen Sie den folgenden Befehl aus, um den MariaDB-Dienst zu starten und zu aktivieren.

sudo systemctl start mariadb  
sudo systemctl enable mariadb

Überprüfen Sie dann den Status des MariaDB-Dienstes mit dem folgenden Befehl.

sudo systemctl status mariadb

Wenn der MariaDB-Server läuft, sollte die Ausgabe wie folgt angezeigt werden:

start enable mariadb

Nginx-Webserver installieren

Nach der Installation des MariaDB-Servers installieren Sie den Nginx-Webserver, der als Reverse-Proxy für Etherpad verwendet wird. Stellen Sie daher sicher, dass Sie einen Domainnamen haben, der auf Ihre Server-IP-Adresse verweist, und SSL-Zertifikate, die über Letsencrypt und Certbot generiert wurden.

Führen Sie den folgenden dnf-Befehl aus, um den Nginx-Webserver zu installieren. Wenn Sie dazu aufgefordert werden, geben Sie y ein, um zu bestätigen, und drücken Sie ENTER.

sudo dnf install nginx

install nginx

Führen Sie nun den folgenden Befehl aus, um den Nginx-Dienst zu starten und zu aktivieren.

sudo systemctl start nginx  
sudo systemctl enable nginx

Geben Sie danach den folgenden Befehl ein, um den Nginx-Dienst zu überprüfen und sicherzustellen, dass der Dienst läuft.

sudo systemctl status nginx

Wenn der Nginx-Dienst läuft, sollten Sie eine Ausgabe wie diese erhalten:

start enable verify nginx

Führen Sie als Nächstes den folgenden Befehl aus, um die HTTP- und HTTPS-Ports auf Ihrem Server zu öffnen.

sudo firewall-cmd --add-service={http,https} --permanent  
sudo firewall-cmd --reload

Überprüfen Sie die Liste der offenen Ports und Dienste mit dem folgenden Befehl. Sie sollten sehen, dass sowohl HTTP als auch HTTPS auf firewalld aktiviert sind.

sudo firewall-cmd --list-all

configure firewalld

MariaDB-Server konfigurieren

In diesem Abschnitt sichern Sie den MariaDB-Server mit dem Dienstprogramm mariadb-secure-installation, erstellen dann eine neue Datenbank und einen Benutzer, die für Etherpad verwendet werden.

Führen Sie den folgenden Befehl aus, um den MariaDB-Server zu sichern.

sudo mariadb-secure-installation

Nachdem der Befehl ausgeführt wurde, werden Sie nach den folgenden Konfigurationen gefragt:

  • Ändern Sie die Authentifizierungsmethode für den MariaDB-Root-Benutzer in unix_socket. Geben Sie n für Nein ein.
    Einrichten des MariaDB-Root-Passworts. Geben Sie y ein, um zu bestätigen, und geben Sie das neue MariaDB-Root-Passwort ein und wiederholen Sie es.
    Deaktivieren Sie die Remote-Anmeldung für den MariaDB-Root-Benutzer. Geben Sie y ein, um zu bestätigen.
    Entfernen Sie die Standarddatenbank test von MariaDB. Geben Sie y ein, um zu bestätigen.
    Entfernen Sie den anonymen Benutzer von MariaDB. Geben Sie y ein, um zu bestätigen.
    Geben Sie schließlich erneut y ein, um die Tabellenberechtigungen neu zu laden und die Änderungen anzuwenden.

Nachdem der MariaDB-Server gesichert ist, erstellen Sie als Nächstes eine neue MariaDB-Datenbank und einen Benutzer.

Melden Sie sich mit dem folgenden mariadb-Befehl am MariaDB-Server an.

sudo mariadb -u root -p

Führen Sie die folgenden Abfragen aus, um eine neue MariaDB-Datenbank und einen Benutzer für Etherpad zu erstellen. In diesem Beispiel erstellen Sie eine neue Datenbank etherpad_lite_db und den Benutzer etherpaduser mit dem Passwort StrongPasswordEtherpadDB.

CREATE DATABASE etherpad_lite_db CHARACTER SET utf8mb4;  
CREATE USER etherpaduser@localhost IDENTIFIED BY 'StrongPasswordEtherpadDB';  
GRANT CREATE,ALTER,SELECT,INSERT,UPDATE,DELETE on etherpad_lite_db.* to etherpaduser@localhost;  
FLUSH PRIVILEGES;

create new database and user

Führen Sie nun die folgende Abfrage aus, um die Berechtigungen für den MariaDB-Benutzer etherpaduser zu überprüfen.

SHOW GRANTS FOR etherpaduser@localhost;  
quit

Sie werden feststellen, dass der MariaDB-Benutzer etherpaduser Berechtigungen hat, um auf die Datenbank etherpad_lite_db zuzugreifen.

show mariadb user privileges

Geben Sie quit ein, um die MariaDB zu verlassen.

Etherpad herunterladen und installieren

In diesem Abschnitt beginnen Sie mit der Etherpad-Installation, indem Sie den Systembenutzer erstellen, den Etherpad-Quellcode herunterladen, die Abhängigkeiten für Etherpad installieren, Etherpad mit der MariaDB-Datenbank integrieren und dann die Installation überprüfen, indem Sie sie über die Befehlszeile ausführen.

Zuerst führen Sie den folgenden Befehl aus, um einen neuen Systembenutzer und die Gruppe ‘etherpad‘ zu erstellen. Dieser Benutzer wird verwendet, um den Etherpad-Dienst auszuführen.

sudo groupadd etherpad  
sudo adduser -r -M -d /opt/etherpad-lite -g etherpad etherpad

Laden Sie den Etherpad-Quellcode über git in das Zielverzeichnis /opt/etherpad-lite herunter.

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

Sobald der Etherpad-Quellcode heruntergeladen ist, führen Sie den folgenden Befehl aus, um den Besitz des Verzeichnisses /opt/etherpad-lite auf den Benutzer und die Gruppe ‘etherpad‘ zu ändern.

sudo chown -R etherpad:etherpad /opt/etherpad-lite

create user and download etherpad source code

Bewegen Sie sich als Nächstes in das Arbeitsverzeichnis /opt/etherpad-lite und installieren Sie die Etherpad-Abhängigkeiten mit dem folgenden Befehl.

cd /opt/etherpad-lite  
sudo su -s /bin/bash -c "./bin/installDeps.sh" etherpad

Nach der Ausführung des Befehls sollten Sie den Installationsprozess wie folgt sehen:

install etherpad dependencies

Wenn die Installation abgeschlossen ist, öffnen Sie die Etherpad-Konfiguration settings.json mit dem folgenden nano-Editor-Befehl.

nano settings.json

Ändern Sie den Titel Ihrer Etherpad-Installation.

  "title": "Etherpad AlmaLinux 9",

Ändern Sie die Standard-IP-Adresse, auf der Etherpad ausgeführt wird, auf localhost oder 127.0.0.1.

  "ip": "127.0.0.1",  
  "port": 9001,

Entfernen Sie die Standarddatenbankkonfiguration unten.

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

Ändern Sie die Datenbankdetails, um den MySQL/MariaDB-Server wie folgt zu verwenden. Und stellen Sie sicher, dass Sie den Datenbanknamen, den Benutzer und das Passwort ändern.

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

Speichern Sie die Datei und schließen Sie den Editor, wenn Sie fertig sind.

Führen Sie als Nächstes den folgenden Befehl aus, um Etherpad zu überprüfen und auszuführen.

/bin/node --experimental-worker /opt/etherpad-lite/node_modules/ep_etherpad-lite/node/server.js

Wenn die Datenbankkonfiguration und die Etherpad-Installation erfolgreich sind, wird die folgende Ausgabe angezeigt:

running check etherpad

Drücken Sie Ctrl+c, um den Prozess zu beenden.

Etherpad als Systemd-Dienst ausführen

Mit der installierten Etherpad-Installation richten Sie Etherpad nun als Systemd-Dienst ein. Dies ermöglicht es Ihnen, Etherpad im Hintergrund auszuführen und Etherpad einfach über die systemctl-Befehlszeile zu verwalten.

Um zu beginnen, erstellen Sie eine neue Systemd-Dienstdatei /lib/systemd/system/etherpad.service mit dem folgenden nano-Editor-Befehl.

sudo nano /lib/systemd/system/etherpad.service

Fügen Sie die folgende Konfiguration in die Datei ein.

[Unit]  
Description=Etherpad-lite, der kollaborative Editor.  
After=syslog.target network.target mariadb.service nginx.service  
  
[Service]  
Type=simple  
User=etherpad  
Group=etherpad  
WorkingDirectory=/opt/etherpad-lite  
Environment=NODE_ENV=production  
ExecStart=/bin/node --experimental-worker /opt/etherpad-lite/node_modules/ep_etherpad-lite/node/server.js  
# verwenden Sie mysql plus eine vollständige settings.json, um die Service-Hold-off-Zeit zu vermeiden, planen Sie einen Neustart.  
Restart=always  
  
[Install]  
WantedBy=multi-user.target

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind.

Führen Sie nun den folgenden Befehl aus, um den Systemd-Manager neu zu laden und die Etherpad-Dienstdatei auf Ihrem System anzuwenden.

sudo systemctl daemon-reload

Starten und aktivieren Sie dann den Etherpad-Dienst mit dem folgenden Befehl.

sudo systemctl start etherpad  
sudo systemctl enable etherpad

Überprüfen Sie den Etherpad-Dienst mit dem folgenden Befehl. Wenn der Etherpad-Dienst läuft, sollten Sie eine Ausgabe wie ‘ active (running) ‘ erhalten.

sudo systemctl status etherpad

verify etherpad service

Sie können auch die Liste der offenen Ports auf Ihrem System mit dem folgenden Befehl überprüfen. Und Sie sollten sehen, dass Etherpad den Port 9001 verwendet.

ss -tulpn | grep 9001

Nginx als Reverse-Proxy konfigurieren

An diesem Punkt läuft Etherpad auf Port 9001. Um es für Endbenutzer zugänglich zu machen, können Sie Nginx verwenden, das als Reverse-Proxy verwendet wird. Stellen Sie vor dem Start sicher, dass Sie den Domainnamen haben, der für Etherpad verwendet wird, und dass Sie SSL-Zertifikate über Letsencrypt und Certbot generiert haben.

Erstellen Sie eine neue Nginx-Serverblockkonfiguration /etc/nginx/conf.d/etherpad.conf mit dem folgenden nano-Editor-Befehl.

sudo nano /etc/nginx/conf.d/etherpad.conf

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie die Details des Domainnamens und den Pfad der SSL-Zertifikate ändern.

# HTTPS erzwingen  
server {  
    listen       80;  
    server_name  etherpad.howtoforge.local;  
    return 301   https://$host$request_uri;  
}  
  
# wir sind hier im http-Kontext  
map $http_upgrade $connection_upgrade {  
    default upgrade;  
    ''      close;  
}  
  
server {  
    listen       443 ssl http2;  
    server_name  etherpad.howtoforge.local;  
  
    access_log  /var/log/nginx/eplite.access.log;  
    error_log   /var/log/nginx/eplite.error.log;  
  
    ssl_certificate      /etc/letsencrypt/live/etherpad.howtoforge.local/fullchain.pem;  
    ssl_certificate_key  /etc/letsencrypt/live/etherpad.howtoforge.local/privkey.pem;  
  
    ssl_session_timeout  5m;  
  
    ssl_protocols TLSv1.2;  
    ssl_prefer_server_ciphers on;  
    ssl_ciphers "EECDH+ECDSA+AESGCM EECDH+aRSA+AESGCM EECDH+ECDSA+SHA384 EECDH+ECDSA+SHA256 EECDH+aRSA+SHA384 EECDH+aRSA+SHA256 EECDH+aRSA+RC4 EECDH EDH+aRSA RC4 !aNULL !eNULL !LOW !3DES !MD5 !EXP !PSK !SRP !DSS";  
  
    location / {  
        proxy_pass         http://127.0.0.1:9001;  
        proxy_buffering    off; # seien Sie vorsichtig, diese Zeile überschreibt keine proxy_buffering, die in einer conf.d/file.conf festgelegt ist  
        proxy_set_header   Host $host;  
        proxy_pass_header  Server;  
  
        # Beachten Sie, dass Sie möglicherweise auch diese Header usw. weitergeben möchten.  
        proxy_set_header    X-Real-IP $remote_addr; # https://nginx.org/en/docs/http/ngx_http_proxy_module.html  
        proxy_set_header    X-Forwarded-For $remote_addr; # EP-Protokolle, um die tatsächliche Remote-IP anzuzeigen  
        proxy_set_header    X-Forwarded-Proto $scheme; # für EP, um das sichere Cookie-Flag zu setzen, wenn https verwendet wird  
        proxy_http_version  1.1; # empfohlen bei Keepalive-Verbindungen  
  
        # WebSocket-Proxying - von https://nginx.org/en/docs/http/websocket.html  
        proxy_set_header  Upgrade $http_upgrade;  
        proxy_set_header  Connection $connection_upgrade;  
    }  
}

Speichern Sie die Datei und schließen Sie den Editor, wenn Sie fertig sind.

Führen Sie nun den folgenden Befehl aus, um sicherzustellen, dass Sie die richtige und ordnungsgemäße Konfiguration haben. Wenn erfolgreich, sollten Sie eine Nachricht wie “Syntax ist ok - Test war erfolgreich“ erhalten.

sudo nginx -t

Geben Sie als Nächstes den folgenden Befehl ein, um den Nginx-Dienst neu zu starten und die Änderungen anzuwenden.

sudo systemctl restart nginx

configure nginx as reverse proxy

Starten Sie danach Ihren Webbrowser und besuchen Sie den Domainnamen der Etherpad-Installation (d.h.: https://etherpad.howtoforge.local/). Sie sollten die Standard-Startseite Ihres Etherpad-Kollaborationseditors sehen.

Erstellen Sie jetzt ein neues Pad, indem Sie den Pad-Namen eingeben und auf OK klicken.

create new pad

Unten sehen Sie nun, dass Sie Etherpad als kollaborativen Editor verwenden können.

etehrpad collaboratuive editor

Fazit

Herzlichen Glückwunsch, Sie haben die Installation von Etherpad mit MariaDB-Datenbank und Nginx-Webserver auf einem AlmaLinux 9-Server abgeschlossen. Sie haben Etherpad außerdem mit SSL-Zertifikaten gesichert. Sie können jetzt Etherpad als Haupt-Kollaborationseditor mit Ihren Freunden/Gruppen/Teams verwenden.

Share: X/Twitter LinkedIn
#Installation

Erhalte neue Beiträge in deinem Posteingang.

Kein Spam. Jederzeit abmelden.