==== etherpad.hadoly.fr ====

====== Description ======

Etherpad est un container lxc sur [[karadoc]].

====== Historique ======

  * 2026-10-23 : grosse mise à jour
  * Création du conteneur et installation d'etherpad en Février 2017
  * Upgrade Ubuntu 16.04 vers 18.04 en avril 2020
  * Upgrade en 20 en janvier 2024
  * Upgrade en 22 en janvier 2024

====== Hack moche ======

depuis le passage en ubuntu 22, pour que npm accepte de fonctionner (lors du démarrage de etherpad) il faut rajouter l'adresse ipv6 dans /etc/hosts:

<code>
#20240111: npm c'est de la 💩, ça force la connexion en IPv4, ce qui ne peut pas fonctionner sur ce conteneur IPv6 Only.
2606:4700::6810:1e22 registry.npmjs.org
</code>


====== Services ======

  * Pad accessible via https://pad.hadoly.fr
  * Les fichiers applicatifs sont stockés dans /home/etherpad/etherpad3
  * node est installé à partir des binaires dans /opt/
  * pnpm est installé via ```npm install -g pnpm```
  * Démarrage du service : ```systemctl start etherpad3.service``` 💣 attention le démarrage est long - 3 4 minutes
  * nodejs, <del>mongodb</del>postgresql
  * pour info: ancienne instance dans /home/etherpad/etherpad-lite / service etherpad.service


===== Mise à jour =====

Il peut être intéressant de faire une mise à jour manuelle des plugins depuis la page d'admin de temps en temps

Le mot de passe permettant d'accéder à l'interface d'admin est dans settings.json

🔧 TODO: revalider cette procédure de mise à jour pour la version 3

```bash
cd /home/etherpad
sudo -u postgres /usr/bin/pg_dump -U postgres etherpad > etherpad.psql.sql
rm -fr etherpad-lite.ORIG
cp -a etherpad-lite{,.ORIG}
cd etherpad-lite
sudo -u etherpad git pull origin master
vimdiff /home/etherpad/etherpad-lite*/settings.json # pour merger les modifications de configuration
chown -R etherpad ~etherpad/etherpad-lite
systemctl restart etherpad
# wait
# wait
# fear uncertainty doubts...
# ...
# enjoy  or see journalctl -xe --unit etherpad
```

Ne pas oublier de mettre à jour [[administration:maj|Gestion des mises à jour]]

====== Supervision / monitoring ======

Services de base et présence de processus "node / etherpad" via [[documentation_technique:supervision|zabbix]]

====== Sauvegarde ======

  * what:
    * /etc
    * /root
    * /home/etherpad
    * /var/lib/postgresql/backups
  * where: vm2
  * how: [[:documentation_technique:sauvegardes]]