====== Installation Etherpad ======
{{tag>"travail collaboratif" "éditeur texte" Etherpad installation}}
Etherpad vous permet d'éditer des documents de manière collaborative en temps réel, un peu comme un éditeur multi-joueurs en direct qui s'exécute dans votre navigateur. Rédigez des articles, des communiqués de presse, des listes de choses à faire, etc. avec vos amis, camarades ou collègues, tous travaillant sur le même document en même temps.

===== Installation Node JS =====
Nous installons node.js
<code>
curl -sL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
</code>

===== Installation Etherpad =====
Nous créons l'utilisateur
<code>
sudo adduser --system --group --home /opt/etherpad etherpad
</code>

Nous téléchargeons la dernière version d'Etherpad
<code>
curl -L https://github.com/ether/etherpad-lite/archive/refs/tags/v2.4.2.tar.gz -o /opt/etherpad/etherpad-2.4.2.tgz
</code>

Nous la dézippons et mettons les bons droits, et le plaçons dans son répertoire de travail
<code>
sudo tar xzf etherpad-2.4.2.tgz
sudo chown -R etherpad: etherpad-lite-2.4.2
sudo mv etherpad-lite-2.4.2/* /opt/etherpad
sudo mv etherpad-lite-2.4.2/.* /opt/etherpad
</code>

À l'issue de l'installation, nous pouvons vérifier la version installée
<code>
node --version
npm --version
</code>

===== Configuration Postgresql =====

Nous créons la base de données, et y attachons l'utilisateur
<code>
sudo -u postgres psql
create user etherpad with encrypted password 'monsupermotdepasse';
create database etherpad with owner etherpad;
grant all privileges on database etherpad to etherpad;
\q
</code>

===== Configuration Etherpad =====
Nous créons le fichier de configuration depuis settings.json.template
<code>
sudo cp settings.json.template settings.json
</code>

Nous éditons le fichier settings.json
<code>
sudo vi settings.json
</code>

Nous ajoutons le connecteur pour Redis
<code>
  "dbType" : "postgres",
  "dbSettings" : {
    "user":     "etherpad",
    "host":     "localhost",
    "port":     5432,
    "password": "montsupermotdepasse",
    "database": "etherpad",
  },
</code>

Nous configurons le compte admin en décommentant / adaptant ce bloc
<code>
  "users": {
    "admin": {
      // 1) "password" can be replaced with "hash" if you install ep_hash_auth
      // 2) please note that if password is null, the user will not be created
      "password": "monsupermotdepasse",
      "is_admin": true
    }
  },
</code>

===== Configuration Systemd =====
Nous créons le fichier qui va permettre de gérer le service à l'aide de Systemd
<code>
sudo vi /etc/systemd/system/etherpad.service
</code>

Nous y ajoutons cette configuration
<code>
[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad
Environment=NODE_ENV=production
ExecStart=pnpm run prod
# use mysql plus a complete settings.json to avoid Service hold-off time over, scheduling restart.
Restart=always

StandardOutput=append:/var/log/etherpad/etherpad.log
StandardError=append:/var/log/etherpad/etherpad-error.log

[Install]
WantedBy=multi-user.target
</code>

Nous rechargeons systemd
<code>
sudo systemctl daemon-reload
</code>

Nous installons les dépendances
<code>
sudo /opt/etherpad/bin/installDeps.sh
sudo chown -R etherpad: /opt/etherpad/
</code>

Nous configurons les logs
<code>
sudo mkdir /var/log/etherpad
sudo chown -R etherpad: /var/log/etherpad/ 
</code>

===== Lancement final =====
Nous activons le service via systemd et le lançons
<code>
sudo systemctl enable --now etherpad.service
</code>

Pour contrôler que le service tourne correctement
<code>
sudo systemctl status etherpad.service
</code>

===== Proxy Nginx =====

Nous installons Nginx
<code>
sudo apt install -y nginx
</code>

Nous créons un vHost Nginx
<code>
sudo vi /etc/nginx/sites-available/pad.domain.tld.conf
</code>

Nous y collons et adaptons ce contenu
<code>
À venir.
</code>

Nous créons le liens symbolique
<code>
cd /etc/nginx/sites-enabled/
sudo ln -s /etc/nginx/sites-available/pad.domain.tld.conf
</code>

Nous vérifions la configuration et la rechargeons
<code>
sudo nginx -t
sudo systemctl reload neginx.service
</code>

===== Liens =====
  * [[https://etherpad.org/|site de l'éditeur]]
  * [[https://github.com/ether/etherpad-lite#installation|documentation installation]]
  * [[https://www.howtoforge.com/tutorial/ubuntu-etherpad-editor-server-installation/|How to Install Collaborative Real-time Editor Etherpad on Ubuntu 18.04]]
  * [[https://etherpad.org/doc/latest/|documentation Etherpad-lite]]
  * [[https://github.com/ether/etherpad-lite/wiki/How-to-use-Etherpad-Lite-with-Redis|How to use Etherpad Lite with Redis]]